IDebugDataSpaces2::ReadHandleData-Methode (dbgeng.h)

Artikel
02/26/2024

Die ReadHandleData-Methode ruft Informationen zu einem Systemobjekt ab, das von einem Systemhandle angegeben wird.

Syntax

HRESULT ReadHandleData(
  [in]            ULONG64 Handle,
  [in]            ULONG   DataType,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  DataSize
);

Parameter

[in] Handle

Gibt das Systemhandle des Objekts an, dessen Daten angefordert werden. Informationen zu Systemhandles finden Sie unter Handles.

[in] DataType

Gibt den Datentyp an, der für das Systemhandle zurückgegeben werden soll. Die folgende Tabelle enthält die gültigen Werte zusammen mit dem entsprechenden Rückgabetyp:

Wert	BESCHREIBUNG
DEBUG_HANDLE_DATA_TYPE_BASIC	Gibt grundlegende Informationen zum Systemobjekt zurück. In diesem Fall kann davon ausgegangen werden, dass das Argument Bufferden Typ PDEBUG_HANDLE_DATA_BASIC hat.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	Gibt den Namen des Objekttyps zurück. Beispiel: "Process" oder "Thread". In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PSTR aufweist.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	Gibt den Namen des Objekts zurück. Dies schließt den Speicherort im Objektverzeichnis ein. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PSTR aufweist.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	Gibt die Anzahl der Handles zurück, die vom -Objekt gespeichert werden. Dies ähnelt dem Feld DEBUG_HANDLE_DATA_BASIC. HandleCount. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PULONG aufweist.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	Gibt den Namen des Objekttyps zurück. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PWSTR aufweist.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Gibt den Namen des Objekts zurück. In diesem Fall kann davon ausgegangen werden, dass das Argument Buffer den Typ PWSTR aufweist.

[out, optional] Buffer

Empfängt die Objektdaten. Nach erfolgreichem Abschluss der Methode kann auf den Inhalt dieses Puffers zugegriffen werden, indem Buffer in den in der obigen Tabelle angegebenen Typ umgewandelt wird.

Wenn BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Gibt die Größe des Pufferpuffers in Byte an. Dies ist die maximale Anzahl von Bytes, die zurückgegeben werden.

[out, optional] DataSize

Empfängt die Größe der Daten in Bytes. Wenn DataSizeNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

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

Hinweise

Diese Methode ist nur im Benutzermodusdebuggen verfügbar.

Anforderungen

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

Weitere Informationen

Ziehpunkte

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Freigeben über