Método IDebugControl::GetDebuggeeType (dbgeng.h)

  • Artigo

O método GetDebuggeeType descreve a natureza do destino atual.

Sintaxe

HRESULT GetDebuggeeType(
  [out] PULONG Class,
  [out] PULONG Qualifier
);

Parâmetros

[out] Class

Recebe a classe do destino atual. Ele será definido como um dos valores na tabela a seguir.

Valor Descrição
DEBUG_CLASS_UNINITIALIZED Não há nenhum destino atual.
DEBUG_CLASS_KERNEL O destino atual é um destino no modo kernel.
DEBUG_CLASS_USER_WINDOWS O destino atual é um destino de modo de usuário.

[out] Qualifier

Fornece mais detalhes sobre o tipo do destino. Sua interpretação depende do valor de Class. Quando a classe é DEBUG_CLASS_UNINITIALIZED, Qualifier retorna zero. Os valores a seguir são aplicáveis para destinos no modo kernel.

Valor Descrição
DEBUG_KERNEL_CONNECTION O destino atual é um kernel dinâmico que está sendo depurado da maneira padrão (usando uma porta COM, um barramento 1394 ou um pipe nomeado).
DEBUG_KERNEL_LOCAL O destino atual é o kernel local.
DEBUG_KERNEL_EXDI_DRIVER O destino atual é um kernel dinâmico conectado usando drivers eXDI.
DEBUG_KERNEL_SMALL_DUMP O destino atual é um arquivo de despejo de memória pequeno no modo kernel.
DEBUG_KERNEL_DUMP O destino atual é um arquivo de despejo de memória kernel no modo kernel.
DEBUG_KERNEL_FULL_DUMP O destino atual é um arquivo de despejo de memória completo no modo kernel.
 

Os valores a seguir são aplicáveis para destinos no modo de usuário.

Valor Descrição
DEBUG_USER_WINDOWS_PROCESS O destino atual é um processo de modo de usuário no mesmo computador que o mecanismo do depurador.
DEBUG_USER_WINDOWS_PROCESS_SERVER O destino atual é um processo de modo de usuário conectado usando um servidor de processo.
DEBUG_USER_WINDOWS_SMALL_DUMP O destino atual é um arquivo minidump no modo de usuário.
DEBUG_USER_WINDOWS_DUMP O destino atual é um arquivo de despejo de User-Mode completo.

Retornar valor

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

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

Requisitos

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