IDebugDataSpaces3::ReadHandleData-Methode (dbgeng.h)

Artikel
02/06/2025

Die ReadHandleData--Methode ruft Informationen zu einem Systemobjekt ab, das durch ein 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 das Argument Buffer als Typ PDEBUG_HANDLE_DATA_BASICbetrachtet werden.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	Gibt den Namen des Objekttyps zurück. Beispiel: "Prozess" oder "Thread". In diesem Fall kann das Argument Buffer als PSTR-Typ angesehen werden.
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 das Argument Buffer als PSTR-Typ angesehen werden.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	Gibt die Anzahl der Ziehpunkte zurück, die vom Objekt gehalten werden. Dies ist mit dem Feld DEBUG_HANDLE_DATA_BASICvergleichbar.HandleCount. In diesem Fall kann das Argument Buffer als typ PULONG betrachtet werden.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	Gibt den Namen des Objekttyps zurück. In diesem Fall kann das Argument Buffer als PwSTR-Typ angesehen werden.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Gibt den Namen des Objekts zurück. In diesem Fall kann das Argument Buffer als PWSTR-Typ angesehen werden.

[out, optional] Buffer

Empfängt die Objektdaten. Nach erfolgreichem Abschluss der Methode kann auf den Inhalt dieses Puffers zugegriffen werden, indem sie Puffer- in den in der obigen Tabelle angegebenen Typ umwandeln.

Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

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

[out, optional] DataSize

Empfängt die Größe der Daten in Byte. Wenn DataSize-NULL-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.

Bemerkungen

Diese Methode ist nur im Benutzermodusdebugging verfügbar.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

Griffe

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4-

Freigeben über