IDebugDataSpaces3::ReadHandleData-Methode (dbgeng.h)

  • Artikel

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 sowie den 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 Buffer den 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 das Argument Buffer den Typ PSTR aufweisen.
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 den Typ PSTR aufweisen.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT Gibt die Anzahl der Handles zurück, die vom -Objekt gehalten werden. Dies ähnelt dem Feld DEBUG_HANDLE_DATA_BASIC. HandleCount.

In diesem Fall kann das Argument Buffer den Typ PULONG aufweisen.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE Gibt den Namen des Objekttyps zurück.

In diesem Fall kann das Argument Buffer den Typ PWSTR aufweisen.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE Gibt den Namen des Objekts zurück.

In diesem Fall kann das Argument Buffer den Typ PWSTR aufweisen.

[out, optional] Buffer

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

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

[in] BufferSize

Gibt die Größe des Pufferpuffers in Bytes 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 beim Debuggen im Benutzermodus verfügbar.

Anforderungen

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

Weitere Informationen

Ziehpunkte

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4