WindowsInspectString-Funktion (winstring.h)

Ermöglicht Debuggern, den Wert eines Windows-Runtime HSTRING in einem anderen Adressraum, remote oder aus einem Dump anzuzeigen.

Syntax

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

Parameter

targetHString

[in]

Der zu überprüfende HSTRING .

machine

Das Format des Zieladressraums. Gültige Werte sind IMAGE_FILE_MACHINE_AMD64 für Win64, IMAGE_FILE_MACHINE_I386 für Win32 oder IMAGE_FILE_MACHINE_ARM für 32-Bit-ARM.

callback

[in]

Eine Rückruffunktion zum Lesen des Zeichenfolgenpuffers aus dem Zieladressraum. Diese Funktion wird aufgerufen, bevor die Parameter length und targetStringAddress von der WindowsInspectString-Funktion berechnet werden.

context

[in, optional]

Benutzerdefinierte Kontextdaten, die an den Rückruf übergeben werden.

length

[out]

Die Länge der Zeichenfolge im Zieladressraum, wenn der Rückrufaufruf erfolgreich ist; andernfalls 0.

targetStringAddress

[out]

Die Zieladresse des unformatierten PCWSTR, wenn der Rückrufaufruf erfolgreich ist; andernfalls NULL.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
E_INVALIDARG	IMAGE_FILE_MACHINE_AMD64 wurde für den Computer angegeben, aber die aktuelle Plattform ist nicht Win64, oder der Computer nicht IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386 oder IMAGE_FILE_MACHINE_ARM ist, oder targetHString ist kein richtig formatierter HSTRING.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Zielplattform	Windows
Kopfzeile	winstring.h
Bibliothek	RuntimeObject.lib
DLL	ComBase.dll

Weitere Informationen

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString