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

Artigo
02/06/2025

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 argumento buffer pode ser considerado como ter PDEBUG_HANDLE_DATA_BASICde tipo.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME	Retorna o nome do tipo de objeto. Por exemplo, "Processo" ou "Thread". Nesse caso, o argumento o buffer 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 argumento o buffer 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 sendo do tipo PULONG.
DEBUG_HANDLE_DATA_TYPE_TYPE_NAME_WIDE	Retorna o nome do tipo de objeto. Nesse caso, o argumento de Buffer pode ser considerado para ter o tipo PWSTR
DEBUG_HANDLE_DATA_TYPE_OBJECT_NAME_WIDE	Retorna o nome do objeto. Nesse caso, o argumento o buffer pode ser considerado como ter 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 pela conversão buffer para o 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 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.

Valor de retorno

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 de Valores Retornados para obter mais detalhes.

Observações

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

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

Manipula

IDebugDataSpaces2

IDebugDataSpaces3

IDebugDataSpaces4

Compartilhar via