WindowsInspectString function
Provides a way to for debuggers to display the value of an Windows Runtime HSTRING in another address space, remotely, or from a dump.
Syntax
HRESULT WINAPI WindowsInspectString(
_In_ UINT_PTR targetHString,
USHORT machine,
PINSPECT_HSTRING_CALLBACK callback,
_In_opt_ void *context,
_Out_ UINT32 *length,
_Out_ UINT_PTR *targetStringAddress
);
Parameters
- targetHString [in]
-
The HSTRING to inspect.
- machine
-
The format of the target address space. Valid values are IMAGE_FILE_MACHINE_AMD64 for Win64, IMAGE_FILE_MACHINE_I386 for Win32, or IMAGE_FILE_MACHINE_ARM for 32-bit ARM.
- callback
-
A callback function to read the string buffer from the target address space. This function is called before the length and targetStringAddress parameters are computed by the WindowsInspectString function.
- context [in, optional]
-
Custom context data passed to the callback.
- length [out]
-
The length of the string in the target address space, if the call to callback is successful; otherwise, 0.
- targetStringAddress [out]
-
The target address of the raw PCWSTR, if the call to callback is successful; otherwise, NULL.
Return value
This function can return one of these values.
| Return code | Description |
|---|---|
|
|
Requirements
|
Minimum supported client |
Windows 8 |
|---|---|
|
Minimum supported server |
Windows Server 2012 |
|
Header |
|
|
Library |
|
|
DLL |
|
See also