Método IDebugClient::AttachProcess (dbgeng.h)

Artículo
08/07/2023

El método AttachProcess conecta el motor del depurador a un modo de usuario.

Sintaxis

HRESULT AttachProcess(
  [in] ULONG64 Server,
  [in] ULONG   ProcessId,
  [in] ULONG   AttachFlags
);

Parámetros

[in] Server

Especifica el servidor de procesos que se va a usar para asociarlo al proceso. Si Server es cero, el motor se conectará a un proceso local sin usar un servidor de procesos.

[in] ProcessId

Especifica el identificador de proceso del proceso de destino al que se asociará el depurador.

[in] AttachFlags

Especifica las marcas que controlan cómo se asocia el depurador al proceso de destino. Para obtener más información sobre estas marcas, vea Comentarios.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

Este método solo está disponible para la depuración en modo usuario activo.

Nota El motor no se asocia completamente al proceso hasta que se haya llamado al método WaitForEvent . Solo después de que el proceso haya generado un evento (por ejemplo, el evento create-process), estará disponible en la sesión del depurador.

Para obtener más información sobre cómo crear y adjuntar a destinos en modo de usuario activo, consulte Destinos de Live User-Mode.

Las marcas de bits DEBUG_ATTACH_XXX controlan cómo se asocia el motor del depurador a un proceso en modo de usuario. Para obtener las opciones DEBUG_ATTACH_XXX que se usan al adjuntar a un destino de kernel, consulte AttachKernel.

En la tabla siguiente se describen los posibles valores de marca.

Constante	Descripción
DEBUG_ATTACH_NONINVASIVE	Adjunte al destino de forma novasiva. Para obtener más información sobre la depuración novasiva, vea Depuración novasiva (modo de usuario). Si se establece esta marca, no se deben establecer las marcas DEBUG_ATTACH_EXISTING, DEBUG_ATTACH_INVASIVE_NO_INITIAL_BREAK y DEBUG_ATTACH_INVASIVE_RESUME_PROCESS.
DEBUG_ATTACH_EXISTING	Vuelva a adjuntar a una aplicación a la que un depurador ya está asociado (y posiblemente abandonado). Para obtener más información sobre cómo volver a adjuntar a destinos, consulte Volver a adjuntar a la aplicación de destino. Si se establece esta marca, no se deben establecer las demás marcas DEBUG_ATTACH_XXX .
DEBUG_ATTACH_NONINVASIVE_NO_SUSPEND	No suspenda los subprocesos del destino al adjuntar de forma novasiva. Si se establece esta marca, también se debe establecer la marca DEBUG_ATTACH_NONINVASIVE.
DEBUG_ATTACH_INVASIVE_NO_INITIAL_BREAK	(Windows XP y versiones posteriores) No solicite un salto inicial al adjuntar al destino. Si se establece esta marca, no se deben establecer las marcas DEBUG_ATTACH_NONINVASIVE y DEBUG_ATTACH_EXISTING.
DEBUG_ATTACH_INVASIVE_RESUME_PROCESS	Si se establece esta marca, no se deben establecer las marcas DEBUG_ATTACH_NONINVASIVE y DEBUG_ATTACH_EXISTING.