Metodo IDebugDataSpaces4::ReadHandleData (dbgeng.h)

Articolo
02/06/2025

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 di cui sono richiesti i dati. Vedere Handle per informazioni sugli 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 di tipo PDEBUG_HANDLE_DATA_BASIC.
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 di tipo PSTR.
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME	Restituisce il nome dell'oggetto. Ciò include il relativo percorso nella directory dell'oggetto. In questo caso, l'argomento buffer può essere considerato di tipo PSTR.
DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT	Restituisce il numero di handle contenuti nell'oggetto . Questo è simile al campo DEBUG_HANDLE_DATA_BASIC.HandleCount. In questo caso, l'argomento Buffer può essere considerato di 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 di 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 metodo, è possibile accedere al contenuto del buffer eseguendo il cast 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 che verranno 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 ha avuto esito positivo.

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Osservazioni

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

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Vedere anche

Manici

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Condividi tramite