Share via

windowsInspectString2 函数 (winstring.h)

  • 项目

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

语法

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

参数

targetHString

[in]

要检查的 HSTRING 。

machine

目标地址空间的格式。 有效值为 win64 IMAGE_FILE_MACHINE_AMD64 、 win32 IMAGE_FILE_MACHINE_I386 或 32 位 ARM 的 IMAGE_FILE_MACHINE_ARM 。

callback

[in]

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

context

[in，可选]

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

length

[out]

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

targetStringAddress

[out]

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

返回值

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

返回代码 说明
E_INVALIDARG
  • 计算机值不是IMAGE_FILE_MACHINE_AMD64、IMAGE_FILE_MACHINE_I386、IMAGE_FILE_MACHINE_ARM或
  • targetHString 不是格式正确的 HSTRING。

注解

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

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

要求

   
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 winstring.h
Library RuntimeObject.lib
DLL ComBase.dll

另请参阅

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString