IDebugProgramEx2::Attach

Присоединение сеанса к программе.

Синтаксис

C#

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

C++

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

Параметры

pCallback
[in] Объект IDebugEventCallback2 , представляющий функцию обратного вызова, в которую подключенная подсистема отладки отправляет события.

dwReason
[in] Значение перечисления ATTACH_REASON , описывающее причину операции присоединения.

pSession
[in] Значение, однозначно определяющее сеанс, присоединенный к программе.

Возвращаемое значение

В случае успешного выполнения возвращается S_OK; в противном случае возвращается код ошибки. Этот метод должен возвращать E_ATTACH_DEBUGGER_ALREADY_ATTACHED , если программа уже подключена.

Замечания

Порт, содержащий программу, может использовать значение в pSession том, чтобы определить, какой сеанс пытается подключиться к программе. Например, если порт позволяет подключать только один сеанс отладки к процессу за раз, порт может определить, подключен ли тот же сеанс к другим программам в процессе.

Примечание.

Переданный интерфейс pSession обрабатывается только как файл cookie, значение, однозначно определяющее диспетчер отладки сеансов, присоединенный к этой программе; ни один из методов в предоставленном интерфейсе не работает.

См. также

• IDebugProgramEx2