IDebugDataSpaces4::ReadUnicodeStringVirtualWide-Methode (dbgeng.h)

Die ReadUnicodeStringVirtualWide--Methode liest eine mit Null beendete Unicode-Zeichenfolge 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 Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

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

 

[in] BufferSize

Gibt die Größe des Puffer- Puffers 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 Puffer-zu passen. Die abgeschnittene Zeichenfolge wird null beendet, wenn Puffer- mindestens ein Zeichen lang leer ist.
E_INVALIDARG	Ein Null-Terminator wurde nach dem Lesen MaxBytes- aus dem Ziel nicht gefunden.

 

Die Methode war erfolgreich.

Bemerkungen

Das Modul liest bis zu MaxBytes aus dem Ziel und sucht nach einem Null-Terminator. Wenn die Zeichenfolge mehr als BufferSize Zeichen enthält, wird die Zeichenfolge abgeschnitten, damit sie in Bufferpassen.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

IDebugDataSpaces4-

ReadMultiByteStringVirtualWide-

ReadUnicodeStringVirtual-