IDebugProgramEx2::Attach
Anexe uma sessão para um programa.
HRESULT Attach(
IDebugEventCallback2* pCallback,
DWORD dwReason,
IDebugSession2* pSession
);
[C#]
int Attach(
IDebugEventCallback2 pCallback,
uint dwReason,
IDebugSession2 pSession
);
Parâmetros
pCallback
[in] Um IDebugEventCallback2 objeto que representa a função de retorno de chamada que o mecanismo de depuração anexado envia eventos.dwReason
[in] Um valor a partir do ATTACH_REASON enumeração que descreve o motivo para a operação de anexação.pSession
[in] Um valor que identifica exclusivamente a sessão que está anexando ao programa.
Valor de retorno
Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro. Esse método deve retornar E_ATTACH_DEBUGGER_ALREADY_ATTACHED se o programa já está anexado.
Comentários
A porta que contém o programa pode usar o valor em pSession para determinar qual sessão está tentando a conexão para o programa. Por exemplo, se uma porta permite que a sessão de depuração de apenas um anexar a um processo por vez, a porta pode determinar se a mesma sessão já está anexada a outros programas no processo.
Dica
A interface do passado no pSession deve ser tratada somente como um cookie, um valor que identifica com exclusividade o Gerenciador de sessão de depuração anexando a este programa. Nenhum dos métodos na interface fornecida são funcionais.