WindowsInspectString2 函数 （winstring.h）

为调试器提供一种方法，用于在另一个地址空间、远程或转储中显示 Windows 运行时 HSTRING 的值。

Syntax

HRESULT WindowsInspectString2(
  UINT64                     targetHString,
  USHORT                     machine,
  PINSPECT_HSTRING_CALLBACK2 callback,
  void                       *context,
  UINT32                     *length,
  UINT64                     *targetStringAddress
);

参数

targetHString

[in]

要检查的 HSTRING 。

machine

目标地址空间的格式。 对于 Win64、win32 IMAGE_FILE_MACHINE_I386或 32 位 ARM IMAGE_FILE_MACHINE_ARM，有效值IMAGE_FILE_MACHINE_AMD64。

callback

[in]

用于从目标地址空间读取字符串缓冲区的回调函数。 在 长度 和 targetStringAddress 参数由 WindowsInspectString2 函数计算之前调用此函数。

context

[in，可选]

传递给回调的自定义上下文数据。

length

[out]

如果调用 回调 成功，则目标地址空间中的字符串长度;否则为 0。

targetStringAddress

[out]

如果调用回调成功，则原始 PCWSTR 的目标地址;否则为 NULL。

返回值

此函数可以返回其中一个值。

注解

WindowsInspectString 函数将输入和输出指针作为本机指针大小的值传递。 如果当前平台为 Win32，该函数将返回 Win64 的进程的错误。

从 Win32 和 Win64 应用程序调用时，WindowsInspectString2 允许最多 64 位值进行跨体系结构调试。

要求

另请参阅

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString