Share via

WindowsInspectString 函数 (winstring.h)

  • 项目

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

语法

HRESULT WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *targetStringAddress
);

参数

targetHString

[in]

要检查的 HSTRING 。

machine

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

callback

[in]

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

context

[in，可选]

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

length

[out]

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

targetStringAddress

[out]

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

返回值

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

返回代码 说明
E_INVALIDARG
  • 已为计算机指定了IMAGE_FILE_MACHINE_AMD64，但当前平台不是 Win64，或者
  • 计算机 不是 IMAGE_FILE_MACHINE_AMD64、 IMAGE_FILE_MACHINE_I386或 IMAGE_FILE_MACHINE_ARM，或者
  • targetHString 不是格式正确的 HSTRING。

要求

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

另请参阅

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString