IDebugDataSpaces4::ReadUnicodeStringVirtualWide-Methode (dbgeng.h)
Die ReadUnicodeStringVirtualWide-Methode liest eine Unicode-Zeichenfolge mit Null-Beendigung aus dem Ziel.
Syntax
HRESULT ReadUnicodeStringVirtualWide(
[in] ULONG64 Offset,
[in] ULONG MaxBytes,
[out, optional] PWSTR 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 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 in Bytes. Wenn StringBytesNULL ist, werden diese Informationen nicht zurückgegeben.
Rückgabewert
Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
|
|
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. |
Die Methode war erfolgreich.
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) |