IDebugDataSpaces4::ReadUnicodeStringVirtual-Methode (dbgeng.h)
Die ReadUnicodeStringVirtual--Methode liest eine null-beendete Unicode-Zeichenfolge aus dem Ziel und konvertiert sie in eine Multibyte-Zeichenfolge.
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 Codeseite an, die zum Konvertieren der Multibyte-Zeichenfolge aus dem Ziel in eine Unicode-Zeichenfolge verwendet werden soll. Beispielsweise ist CP_ACP die ANSI-Codeseite.
[out, optional] Buffer
Empfängt die Zeichenfolge vom Ziel. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.
[in] BufferSize
Gibt die Größe des Puffer- Puffers 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 Puffer-zu passen. Die abgeschnittene Zeichenfolge wird null beendet, wenn Puffer- mindestens ein Zeichen lang leer ist. |
|
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 und sucht nach einem Null-Terminator. 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, Winnls.h) |