Freigeben über

IDebugDataSpaces4::ReadUnicodeStringVirtual-Methode (dbgeng.h)

Die ReadUnicodeStringVirtual--Methode liest eine null-beendete Unicode-Zeichenfolge aus dem Ziel und konvertiert sie in eine Multibyte-Zeichenfolge.

Syntax

HRESULT ReadUnicodeStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [in]            ULONG   CodePage,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  StringBytes
);

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Prozesses der Zeichenfolge 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

Rückgabecode Beschreibung
S_OK
 Die Methode war erfolgreich.
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.
 

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.

Anforderungen

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

Siehe auch

IDebugDataSpaces4-

ReadMultiByteStringVirtual-

ReadUnicodeStringVirtualWide

  • Last updated on