共用方式為

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]

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

context

[in, optional]

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

length

[out]

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

targetStringAddress

[out]

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

傳回值

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

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

另請參閱

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString