IDebugProgramEx2::Attach

Anexar uma sessão a um programa.

Sintaxe

int Attach( 
   IDebugEventCallback2 pCallback,
   uint                 dwReason,
   IDebugSession2       pSession
);

HRESULT Attach( 
   IDebugEventCallback2* pCallback,
   DWORD                 dwReason,
   IDebugSession2*       pSession
);

Parâmetros

pCallback
[em] Um objeto IDebugEventCallback2 que representa a função de retorno de chamada para a qual o mecanismo de depuração anexado envia eventos.

dwReason
[em] Um valor da enumeração ATTACH_REASON que descreve o motivo da operação de anexação.

pSession
[em] Um valor que identifica exclusivamente a sessão que está anexando ao programa.

Valor de retorno

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro. Esse método deve retornar E_ATTACH_DEBUGGER_ALREADY_ATTACHED se o programa já estiver anexado.

Comentários

A porta que contém o programa pode usar o valor em pSession para determinar qual sessão está tentando anexar ao programa. Por exemplo, se uma porta permitir que apenas uma sessão de depuração seja anexada a um processo por vez, a porta poderá determinar se a mesma sessão já está anexada a outros programas no processo.

Confira também

• IDebugProgramEx2