IDebugDataSpaces4::ReadUnicodeStringVirtualWide-Methode (dbgeng.h)

Artikel
02/23/2024

Die ReadUnicodeStringVirtualWide-Methode liest eine Unicode-Zeichenfolge mit Null-Beendigung aus dem Ziel.

Syntax

HRESULT ReadUnicodeStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PWSTR   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

Parameter

[in] Offset

Gibt den Speicherort der Zeichenfolge im virtuellen Adressraum des Prozesses an.

[in] MaxBytes

Gibt die maximale Anzahl von Bytes an, die aus dem Ziel gelesen werden sollen.

[out, optional] Buffer

Empfängt die Zeichenfolge vom Ziel. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

Hinweis Der Rest des Puffers, der der zurückgegebenen Zeichenfolge folgt, kann von dieser Methode überschrieben werden.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Zeichen an.

[out, optional] StringBytes

Empfängt die Größe der Zeichenfolge in Bytes. Wenn StringBytesNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK
S_FALSE	Die Methode war erfolgreich. Puffer war jedoch nicht groß genug, um die Zeichenfolge zu halten, und die Zeichenfolge wurde abgeschnitten, um in Buffer zu passen. Die abgeschnittene Zeichenfolge ist NULL-beendet, wenn Puffer über Platz für mindestens ein Zeichen verfügt.
E_INVALIDARG	Nach dem Lesen von MaxBytes aus dem Ziel wurde kein NULL-Abschlussator gefunden.

Die Methode war erfolgreich.

Hinweise

Die Engine liest bis maxBytes vom Ziel ein und sucht nach einem NULL-Abschlussator. Wenn die Zeichenfolge mehr als BufferSize-Zeichen enthält, wird die Zeichenfolge so abgeschnitten, dass sie in Buffer passt.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual

Freigeben über