Metodo IDebugDataSpaces3::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 di cui sono richiesti i dati. Per informazioni sugli handle di sistema, vedere Handle.

[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, "Process" 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 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 mantenuti dall'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 di questo buffer eseguendo il cast di 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 è stato eseguito correttamente.

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

Commenti

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

Requisiti

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

Vedi anche

Selettori

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Condividi tramite