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.
[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 |
|---|---|
|
Die Methode war erfolgreich. |
|
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. |
|
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) |