IDebugDataSpaces4::ReadMultiByteStringVirtualWide-Methode (dbgeng.h)

Die ReadMultiByteStringVirtualWide--Methode liest eine null-beendete, multibyte-Zeichenfolge aus dem Ziel und konvertiert sie in Unicode.

Syntax

HRESULT ReadMultiByteStringVirtualWide(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [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.

[in] CodePage

Gibt die Codeseite an, die zum Konvertieren der Multibyte-Zeichenfolge aus dem Ziel in eine Unicode-Zeichenfolge verwendet werden soll. Beispielsweise ist CP_ACP die ANSI-Codeseite.

[out, optional] Buffer

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

[in] BufferSize

Gibt die Größe des Puffer- Puffers in Zeichen an.

[out, optional] StringBytes

Empfängt die Größe der Zeichenfolge im Ziel 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.

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.

Beachten Sie, dass der Puffer möglicherweise nicht groß genug war, auch wenn S_OK zurückgegeben wird, um die Zeichenfolge zu speichern. In diesem Fall wird die Zeichenfolge abgeschnitten, damit sie in Puffer-passen. Die abgeschnittene Zeichenfolge wird null beendet, wenn Puffer- mindestens ein Zeichen lang leer ist. Überprüfen Sie nach dem Zurückgeben des Aufrufs, ob *StringBytes größer als BufferSize ist.

Anforderungen

Siehe auch

IDebugDataSpaces4-

ReadMultiByteStringVirtual-

ReadUnicodeStringVirtualWide