WindowsInspectString 函式（winstring.h）

提供偵錯工具在另一個位址空間中、遠端或從傾印顯示 Windows 執行階段 HSTRING 值的方法。

語法

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

參數

targetHString

[在]

要檢查的 HSTRING 。

machine

目標位址空間的格式。 Win64 的有效值為 IMAGE_FILE_MACHINE_AMD64，Win32 的有效值為 IMAGE_FILE_MACHINE_I386,32 位 ARM 的有效值為 IMAGE_FILE_MACHINE_ARM。

callback

[在]

從目標位址空間讀取字串緩衝區的回呼函式。此函式會在 WindowsInspectString 函式計算長度和targetStringAddress 參數之前呼叫。

context

[in，可選]

傳遞至回呼的自訂內容資料。

length

[出]

目標位址空間中字串的長度，如果呼叫回呼成功;否則為 0。

targetStringAddress

[出]

原始 PCWSTR 的目標位址（如果呼叫回呼成功）;否則，為 NULL。

返回值

此函式可以傳回其中一個值。

回傳碼	Description
E_INVALIDARG	已為電腦指定IMAGE_FILE_MACHINE_AMD64，但目前的平台不是 Win64，或機器不是 IMAGE_FILE_MACHINE_AMD64、 IMAGE_FILE_MACHINE_I386或 IMAGE_FILE_MACHINE_ARM，或 targetHString 不是正確格式的 HSTRING。

需求

Requirement	價值觀
最低支援的用戶端	視窗8
支援的最低伺服器	Windows 伺服器 2012
目標平臺	窗戶
Header	winstring.h
Library	RuntimeObject.lib 的檔案
DLL	ComBase.dll