WindowsInspectString2-Funktion (winstring.h)
Ermöglicht Debuggern, den Wert eines Windows-Runtime HSTRING in einem anderen Adressraum, remote oder aus einem Dump anzuzeigen.
Syntax
HRESULT WindowsInspectString2(
UINT64 targetHString,
USHORT machine,
PINSPECT_HSTRING_CALLBACK2 callback,
void *context,
UINT32 *length,
UINT64 *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 WindowsInspectString2-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 |
|---|---|
|
|
Hinweise
Die WindowsInspectString-Funktion übergibt die Eingabe- und Ausgabezeiger als native Zeigergröße. Wenn die aktuelle Plattform Win32 ist, gibt diese Funktion einen Fehler für Prozesse zurück, die Win64 sind.
WindowsInspectString2 ermöglicht architekturübergreifendes Debuggen, indem bis zu 64-Bit-Werte zugelassen werden, wenn sie sowohl von Win32- als auch von Win64-Anwendungen aufgerufen werden.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Windows |
| Kopfzeile | winstring.h |
| Bibliothek | RuntimeObject.lib |
| DLL | ComBase.dll |