Share via

IDebugProgramEx2::Attach

  • Artículo

Adjunte una sesión a un programa.

Sintaxis

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

Parámetros

pCallback
[in] Objeto IDebugEventCallback2 que representa la función de devolución de llamada a la que el motor de depuración adjunto envía eventos.

dwReason
[in] Valor de la enumeración ATTACH_REASON que describe el motivo de la operación de asociación.

pSession
[in] Valor que identifica de forma única la sesión que está adjuntando al programa.

Valor devuelto

Si la operación se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error. Este método debe devolver E_ATTACH_DEBUGGER_ALREADY_ATTACHED si el programa ya está asociado.

Comentarios

El puerto que contiene el programa puede usar el valor de para determinar en pSession qué sesión se está intentando adjuntar al programa. Por ejemplo, si un puerto solo permite que una sesión de depuración se adjunte a un proceso a la vez, el puerto puede determinar si la misma sesión ya está asociada a otros programas del proceso.

Nota:

La interfaz pasada pSession solo se trata como una cookie, un valor que identifica de forma única el administrador de depuración de sesión que se asocia a este programa; ninguno de los métodos de la interfaz proporcionada es funcional.

Consulte también