IDebugSymbols::ReadTypedDataVirtual-Methode (dbgeng.h)

Artikel
02/26/2024

Die ReadTypedDataVirtual-Methode liest den Wert einer Variablen im virtuellen Arbeitsspeicher des Ziels.

Syntax

HRESULT ReadTypedDataVirtual(
  [in]            ULONG64 Offset,
  [in]            ULONG64 Module,
  [in]            ULONG   TypeId,
  [out]           PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  BytesRead
);

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressraum des Ziels der zu lesenden Variablen an.

[in] Module

Gibt die Basisadresse des Moduls an, das den Typ der Variablen enthält.

[in] TypeId

Gibt die Typ-ID des Typs an.

[out] Buffer

Empfängt die gelesenen Daten.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Bytes an. Dies ist die maximale Anzahl von Bytes, die gelesen werden sollen.

[out, optional] BytesRead

Empfängt die Anzahl der Bytes, die gelesen wurden. Wenn BytesReadNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der Pufferpuffer war jedoch nicht groß genug, um alle Daten aufzunehmen, und er wurde abgeschnitten.

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

Hinweise

Die Anzahl der Bytes, die diese Methode zu lesen versucht, ist die kleinere Größe des Puffers und die Größe der Variablen.

Dies ist eine Komfortmethode. Das gleiche Ergebnis kann durch Aufrufen von GetTypeSize und ReadVirtual erzielt werden.

Weitere Informationen zu Typen finden Sie unter Typen.

Anforderungen

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