Funzione WindowsInspectString2 (winstring.h)

Fornisce un modo per consentire ai debugger di visualizzare il valore di un HSTRING di Windows Runtime in un altro spazio indirizzi, in remoto o da un dump.

Sintassi

HRESULT WindowsInspectString2(
  UINT64                     targetHString,
  USHORT                     machine,
  PINSPECT_HSTRING_CALLBACK2 callback,
  void                       *context,
  UINT32                     *length,
  UINT64                     *targetStringAddress
);

Parametri

targetHString

[in]

HSTRING da controllare.

machine

Formato dello spazio indirizzi di destinazione. I valori validi sono IMAGE_FILE_MACHINE_AMD64 per Win64, IMAGE_FILE_MACHINE_I386 per Win32 o IMAGE_FILE_MACHINE_ARM per ARM a 32 bit.

callback

[in]

Funzione di callback per leggere il buffer di stringa dallo spazio indirizzi di destinazione. Questa funzione viene chiamata prima che i parametri length e targetStringAddress vengano calcolati dalla funzione WindowsInspectString2 .

context

[in, facoltativo]

Dati di contesto personalizzati passati al callback.

length

[out]

Lunghezza della stringa nello spazio indirizzi di destinazione, se la chiamata al callback ha esito positivo; in caso contrario, 0.

targetStringAddress

[out]

Indirizzo di destinazione del PCWSTR non elaborato, se la chiamata al callback ha esito positivo; in caso contrario, NULL.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Description
E_INVALIDARG	Il valore del computer non è IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 o IMAGE_FILE_MACHINE_ARM o targetHString non è un HSTRING formato correttamente.

Osservazioni:

La funzione WindowsInspectString passa i puntatori di input e di output come valori di dimensioni del puntatore nativo. Se la piattaforma corrente è Win32, tale funzione restituisce un errore per i processi Win64.

WindowsInspectString2 abilita il debug tra architetture consentendo fino a 64 bit quando viene chiamato da applicazioni Win32 e Win64.

Requisiti

Requisito	Value
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Header	winstring.h
Library	RuntimeObject.lib
DLL	ComBase.dll

Vedere anche

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString