WindowsInspectString 函数 (winstring.h)

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

Syntax

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

参数

targetHString

[in]

要检查的 HSTRING

machine

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

callback

[in]

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

context

[in,可选]

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

length

[out]

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

targetStringAddress

[out]

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

返回值

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

返回代码 Description
E_INVALIDARG
  • 已为计算机指定了IMAGE_FILE_MACHINE_AMD64,但当前平台不是 Win64,或者
  • 计算机 不是 IMAGE_FILE_MACHINE_AMD64IMAGE_FILE_MACHINE_I386IMAGE_FILE_MACHINE_ARM,或者
  • targetHString 不是格式正确的 HSTRING

要求

Requirement 价值
最低支持的客户端 Windows 8操作系统
支持的最低服务器 Windows Server 2012
目标平台 Windows操作系统
Header winstring.h
Library RuntimeObject.lib
DLL ComBase.dll

另请参阅

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString