IDebugDataSpaces4::ReadMultiByteStringVirtual-Methode (dbgeng.h)

Die ReadMultiByteStringVirtual-Methode liest eine null-endende Multibytezeichenfolge 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 BufferNULL 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 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

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Buffer 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-endend, wenn Buffer über Platz für mindestens ein Zeichen verfügt.
E_INVALIDARG	Nach dem Lesen von MaxBytes aus dem Ziel wurde kein NULL-Abschlusszeichen gefunden.

 

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

Hinweise

Die Engine liest bis zu MaxBytes vom Ziel aus, um nach einem NULL-Abschlusszeichen zu suchen. Wenn die Zeichenfolge mehr als BufferSize-Zeichen enthält, wird die Zeichenfolge abgeschnitten, damit sie in Buffer passt.

Anforderungen

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

Weitere Informationen

IDebugDataSpaces4

ReadMultiByteStringVirtualWide

ReadUnicodeStringVirtual