Compartilhar via


Método IDebugDataSpaces3::ReadHandleData (dbgeng.h)

O método ReadHandleData recupera informações sobre um objeto do sistema especificado por um identificador do sistema.

Sintaxe

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

Parâmetros

[in] Handle

Especifica o identificador do sistema do objeto cujos dados são solicitados. Consulte Identificadores para obter informações sobre identificadores do sistema.

[in] DataType

Especifica o tipo de dados a ser retornado para o identificador do sistema. A tabela a seguir contém os valores válidos, juntamente com o tipo de retorno correspondente:

Valor Descrição
DEBUG_HANDLE_DATA_TYPE_BASIC Retorna informações básicas sobre o objeto do sistema.

Nesse caso, o buffer de argumento pode ser considerado com o tipo PDEBUG_HANDLE_DATA_BASIC.

DEBUG_HANDLE_DATA_TYPE_TYPE_NAME Retorna o nome do tipo de objeto. Por exemplo, "Processo" ou "Thread".

Nesse caso, o buffer de argumento pode ser considerado com o tipo PSTR.

DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME Retorna o nome do objeto . Isso inclui sua localização no diretório do objeto.

Nesse caso, o buffer de argumento pode ser considerado com o tipo PSTR.

DEBUG_HANDLE_DATA_TYPE_HANDLE_COUNT Retorna o número de identificadores mantidos pelo objeto . Isso é semelhante ao campo DEBUG_HANDLE_DATA_BASIC. HandleCount.

Nesse caso, o argumento Buffer pode ser considerado como tendo o tipo PULONG.

DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE Retorna o nome do tipo de objeto.

Nesse caso, o buffer de argumento pode ser considerado como tendo o tipo PWSTR

DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE Retorna o nome do objeto .

Nesse caso, o buffer de argumento pode ser considerado com o tipo PWSTR.

[out, optional] Buffer

Recebe os dados do objeto. Após a conclusão bem-sucedida do método, o conteúdo desse buffer pode ser acessado convertendo Buffer no tipo especificado na tabela acima.

Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho em bytes do Buffer de buffer. Esse é o número máximo de bytes que serão retornados.

[out, optional] DataSize

Recebe o tamanho dos dados em bytes. Se DataSize for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
 

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Comentários

Esse método só está disponível na depuração no modo de usuário.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

Alças

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4