Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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