IDebugDataSpaces4::ReadUnicodeStringVirtual-Methode (dbgeng.h)
Die ReadUnicodeStringVirtual-Methode liest eine null-beendete Unicode-Zeichenfolge aus dem Ziel und konvertiert sie in eine Multibytezeichenfolge.
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 Codepage an, mit der die vom Ziel gelesene Multibytezeichenfolge in eine Unicode-Zeichenfolge konvertiert werden soll. Beispielsweise ist CP_ACP die ANSI-Codepage.
[out, optional] Buffer
Empfängt die Zeichenfolge vom Ziel. Wenn PufferNULL 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 im Ziel in Bytes. Wenn StringBytesNULL ist, werden diese Informationen nicht zurückgegeben.
Rückgabewert
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode war erfolgreich. |
|
Die Methode war erfolgreich. Puffer 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-beendet, wenn Puffer über Platz für mindestens ein Zeichen verfügt. |
|
Nach dem Lesen von MaxBytes aus dem Ziel wurde kein NULL-Abschlussator gefunden. |
Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .
Hinweise
Die Engine liest bis maxBytes vom Ziel ein und sucht nach einem NULL-Abschlussator. Wenn die Zeichenfolge mehr als BufferSize-Zeichen enthält, wird die Zeichenfolge so abgeschnitten, dass sie in Buffer passt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | dbgeng.h (einschließlich Dbgeng.h, Winnls.h) |