Método IDebugClient5::CreateProcessWide (dbgeng.h)

Artículo
02/23/2024

El método CreateProcessWide crea un proceso a partir de la línea de comandos especificada.

Sintaxis

HRESULT CreateProcessWide(
  [in] ULONG64 Server,
  [in] PWSTR   CommandLine,
  [in] ULONG   CreateFlags
);

Parámetros

[in] Server

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

[in] CommandLine

Especifica la línea de comandos que se va a ejecutar para crear el nuevo proceso. El método CreateProcessWide puede modificar el contenido de la cadena que proporcione en este parámetro. Por lo tanto, este parámetro no puede ser un puntero a la memoria de solo lectura (como una variable const o una cadena literal). Pasar una cadena constante en este parámetro puede provocar una infracción de acceso.

[in] CreateFlags

Especifica las marcas que se van a usar al crear el proceso. Para obtener más información sobre estas marcas, consulte el miembro CreateFlags de la estructura DEBUG_CREATE_PROCESS_OPTIONS .

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.

Si CreateFlags contiene cualquiera de las marcas DEBUG_PROCESS o DEBUG_ONLY_THIS_PROCESS, el motor también se adjunta al proceso recién creado. Este comportamiento es similar al de CreateProcessAndAttach2 cuando su argumento ProcessId se establece en cero.

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.