共用方式為

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]

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

context

[in, optional]

傳遞至回呼的自定義內容數據。

length

[out]

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

targetStringAddress

[out]

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

傳回值

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

傳回碼 Description
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
程式庫 RuntimeObject.lib
Dll ComBase.dll

另請參閱

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString