WindowsInspectString2-Funktion (winstring.h)

Bietet eine Möglichkeit zum Anzeigen des Werts eines Windows-Runtime-HSTRING in einem anderen Adressbereich, remote oder aus einem Dump.

Syntax

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

Die Parameter

targetHString

[in]

Der zu prüfende HSTRING.The HSTRING to inspect.

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 WindowsInspectString2-Funktion berechnet werden.

context

[in, optional]

An den Rückruf übergebene benutzerdefinierte Kontextdaten.

length

[out]

Die Länge der Zeichenfolge im Zieladressbereich, 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.

Bemerkungen

Die WindowsInspectString-Funktion übergibt die Eingabe- und Ausgabezeiger als systemeigene Zeigergrößenwerte. Wenn die aktuelle Plattform Win32 ist, gibt diese Funktion einen Fehler für Prozesse zurück, die Win64 sind.

WindowsInspectString2 ermöglicht das architekturübergreifende Debuggen, indem bis zu 64-Bit-Werte zulässig sind, wenn sie von Win32- und Win64-Anwendungen aufgerufen werden.

Anforderungen

Siehe auch

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString

WindowsInspectString