Freigeben über


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

Rückgabecode Description
E_INVALIDARG
  • IMAGE_FILE_MACHINE_AMD64 wurde für Computer angegeben, die aktuelle Plattform ist jedoch nicht Win64 oder
  • computer is not IMAGE_FILE_MACHINE_AMD64, IMAGE_FILE_MACHINE_I386, or IMAGE_FILE_MACHINE_ARM, or
  • targetHString ist kein richtig gebildeter HSTRING-Wert.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 8
Mindestanforderungen für unterstützte Server Windows Server 2012
Zielplattform Fenster
Header winstring.h
Library RuntimeObject.lib
DLL ComBase.dll

Siehe auch

HSTRING

PINSPECT_HSTRING_CALLBACK

WindowsCreateString