IDebugProcess2::Attach
Anexa o gerenciador de depuração de sessão (SDM) ao processo.
Sintaxe
int Attach(
IDebugEventCallback2 pCallback,
Guid[] rgguidSpecificEngines,
uint celtSpecificEngines,
int[] rghrEngineAttach
);
Parâmetros
pCallback
[em] Um objeto IDebugEventCallback2 que é usado para notificação de evento de depuração.
rgguidSpecificEngines
[em] Uma matriz de GUIDs de mecanismos de depuração a serem usados para depurar programas em execução no processo. Esse parâmetro pode ser um valor nulo. Consulte Comentários para obter detalhes.
celtSpecificEngines
[em] O número de mecanismos de depuração na rgguidSpecificEngines matriz e o tamanho da rghrEngineAttach matriz.
rghrEngineAttach
[dentro, fora] Uma matriz de códigos HRESULT retornados pelos mecanismos de depuração. O tamanho dessa matriz é especificado no celtSpecificEngines parâmetro. Cada código é normalmente ou S_OKS_ATTACH_DEFERRED. Este último indica que o DE está atualmente anexado a nenhum programa.
Valor de retorno
Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro. A tabela a seguir mostra outros valores possíveis.
| Valor | Descrição |
|---|---|
E_ATTACH_DEBUGGER_ALREADY_ATTACHED |
O processo especificado já está anexado ao depurador. |
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION |
Ocorreu uma violação de segurança durante o procedimento de anexação. |
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP |
Um processo da área de trabalho não pode ser anexado ao depurador. |
Comentários
A anexação a um processo anexa o SDM a todos os programas em execução nesse processo que podem ser depurados pelos mecanismos de depuração (DE) especificados na rgguidSpecificEngines matriz. Defina o rgguidSpecificEngines parâmetro como um valor nulo ou inclua GUID_NULL na matriz para anexar a todos os programas no processo.
Todos os eventos de depuração que ocorrem no processo são enviados para o objeto IDebugEventCallback2 fornecido. Esse IDebugEventCallback2 objeto é fornecido quando o SDM chama esse método.