Método IDebugControl7::GetDebuggeeType2 (dbgeng.h)

Artigo
02/06/2025

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

Sintaxe

HRESULT GetDebuggeeType2(
  [in]  ULONG  Flags,
  [out] PULONG Class,
  [out] PULONG Qualifier
);

Parâmetros

[in] Flags

Usa um único sinalizador, DEBUG_EXEC_FLAGS_NONBLOCK, que indica se a função GetDebuggeeType2 deve ser proprietária do objeto de seção crítica do mecanismo (g_EngineLock) antes de encontrar o tipo de depuração.

Se o Sinalizador estiver presente, a função tentará ser proprietária da seção crítica. Se isso falhar, ele continuará sem bloquear o thread do chamador.

Se o sinalizador não for passado, a função aguardará a seção crítica do mecanismo ficar disponível antes de continuar.

[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 no modo de usuário.

[out] Qualifier

Fornece mais detalhes sobre o tipo do destino. Sua interpretação depende do valor da classe . 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 sendo depurado da maneira padrão (usando uma porta COM, um barramento 1394 ou 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 de 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.

Valor de retorno

Esse método não retorna um valor.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h

Consulte também

IDebugControl7

Compartilhar via