Funzione WindowsInspectString (winstring.h)

Articolo
03/04/2024

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

Sintassi

HRESULT WindowsInspectString(
  UINT_PTR                  targetHString,
  USHORT                    machine,
  PINSPECT_HSTRING_CALLBACK callback,
  void                      *context,
  UINT32                    *length,
  UINT_PTR                  *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 WindowsInspectString .

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	Descrizione
E_INVALIDARG	IMAGE_FILE_MACHINE_AMD64 è stato specificato per il computer, ma la piattaforma corrente non è Win64 o il computer non è IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 o IMAGE_FILE_MACHINE_ARM o targetHString non è un HSTRING formato correttamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	winstring.h
Libreria	RuntimeObject.lib
DLL	ComBase.dll

Vedi anche

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

Condividi tramite