Método IDebugControl7::GetDebuggeeType2 (dbgeng.h)
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á possuir a 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 de 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. |
Retornar valor
Esse método não retorna um valor.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | dbgeng.h |