Metodo IDebugDataSpaces2::ReadHandleData (dbgeng.h)

Articolo
02/23/2024

Il metodo ReadHandleData recupera informazioni su un oggetto di sistema specificato da un handle di sistema.

Sintassi

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

Parametri

[in] Handle

Specifica l'handle di sistema dell'oggetto i cui dati sono richiesti. Per informazioni sugli handle di sistema, vedere Handle di sistema.

[in] DataType

Specifica il tipo di dati da restituire per l'handle di sistema. La tabella seguente contiene i valori validi, insieme al tipo restituito corrispondente:

Valore	Descrizione
DEBUG_HANDLE_DATA_TYPE_BASIC	Restituisce informazioni di base sull'oggetto di sistema. In questo caso, l'argomento Buffer può essere considerato PDEBUG_HANDLE_DATA_BASIC di tipo.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	Restituisce il nome del tipo di oggetto. Ad esempio, "Processo" o "Thread". In questo caso, l'argomento Buffer può essere considerato come PSTR di tipo.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	Restituisce il nome dell'oggetto. Ciò include la posizione nella directory dell'oggetto. In questo caso, l'argomento Buffer può essere considerato come PSTR di tipo.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	Restituisce il numero di handle mantenuti dall'oggetto . È simile al campo DEBUG_HANDLE_DATA_BASIC. HandleCount. In questo caso, l'argomento Buffer può essere considerato come tipo PULONG.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	Restituisce il nome del tipo di oggetto. In questo caso, l'argomento Buffer può essere considerato in base al tipo PWSTR
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Restituisce il nome dell'oggetto. In questo caso, l'argomento Buffer può essere considerato di tipo PWSTR.

[out, optional] Buffer

Riceve i dati dell'oggetto. Al termine del completamento del metodo, è possibile accedere al contenuto di questo buffer eseguendo il cast del buffer al tipo specificato nella tabella precedente.

Se buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

Specifica le dimensioni in byte del buffer buffer. Si tratta del numero massimo di byte restituiti.

[out, optional] DataSize

Riceve le dimensioni dei dati in byte. Se DataSize è NULL, queste informazioni non vengono restituite.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Commenti

Questo metodo è disponibile solo nel debug in modalità utente.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (includere Dbgeng.h)

Vedi anche

Selettori

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Condividi tramite