IDebugProgramEx2::Attach

将会话附加到程序。

语法

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

参数

pCallback
[in]IDebugEventCallback2 对象,该对象表示附加调试引擎向其发送事件的回调函数。

dwReason
[in]ATTACH_REASON枚举中的一个值,用于描述附加操作的原因。

pSession
[in]唯一标识附加到程序的会话的值。

返回值

如果成功,则返回 S_OK;否则,返回错误代码。 如果程序已附加,此方法应返回 E_ATTACH_DEBUGGER_ALREADY_ATTACHED

备注

包含程序的端口可以使用值 pSession 来确定尝试附加到程序的会话。 例如,如果端口一次只允许一个调试会话附加到进程,则端口可以确定同一会话是否已附加到进程中的其他程序。

注意

传入 pSession 的接口仅被视为 Cookie,该值唯一标识附加到此程序的会话调试管理器;提供接口上的方法都不起作用。

另请参阅