IDebugProcess2::Attach
Asocia el administrador de depuración de sesión (SDM) al proceso.
Sintaxis
int Attach(
IDebugEventCallback2 pCallback,
Guid[] rgguidSpecificEngines,
uint celtSpecificEngines,
int[] rghrEngineAttach
);
Parámetros
pCallback
[in] Objeto IDebugEventCallback2 que se usa para la notificación de eventos de depuración.
rgguidSpecificEngines
[in] Matriz de GUID de motores de depuración que se usarán para depurar programas que se ejecutan en el proceso. Este parámetro puede ser un valor NULL. Consulte Comentarios para obtener más detalles.
celtSpecificEngines
[in] Número de motores de depuración en la rgguidSpecificEngines matriz y el tamaño de la rghrEngineAttach matriz.
rghrEngineAttach
[dentro, fuera] Matriz de códigos HRESULT devueltos por los motores de depuración. El tamaño de esta matriz se especifica en el celtSpecificEngines parámetro . Normalmente S_OK , cada código es o S_ATTACH_DEFERRED. Este último indica que el DE está asociado actualmente a ningún programa.
Valor devuelto
Si la operación se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error. En la tabla siguiente se muestran otros valores posibles.
| Value | Descripción |
|---|---|
E_ATTACH_DEBUGGER_ALREADY_ATTACHED |
El proceso especificado ya está asociado al depurador. |
E_ATTACH_DEBUGGEE_PROCESS_SECURITY_VIOLATION |
Se produjo una infracción de seguridad durante el procedimiento adjunto. |
E_ATTACH_CANNOT_ATTACH_TO_DESKTOP |
No se puede asociar un proceso de escritorio al depurador. |
Comentarios
La asociación a un proceso asocia el SDM a todos los programas que se ejecutan en ese proceso que los motores de depuración (DE) especifican en la rgguidSpecificEngines matriz. Establezca el rgguidSpecificEngines parámetro en un valor NULL o incluya GUID_NULL en la matriz para adjuntar a todos los programas del proceso.
Todos los eventos de depuración que se producen en el proceso se envían al objeto IDebugEventCallback2 especificado. Este IDebugEventCallback2 objeto se proporciona cuando el SDM llama a este método.