IDebugDataSpaces4::ReadMultiByteStringVirtual-Methode (dbgeng.h)

Artikel
02/06/2025

Die ReadMultiByteStringVirtual--Methode liest eine mit Null beendete Multibyte-Zeichenfolge aus dem Ziel.

Syntax

HRESULT ReadMultiByteStringVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG   MaxBytes,
  [out, optional] PSTR    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

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, das nach einem Null-Endator sucht. 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-

Freigeben über