Compartir a través de


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

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 asociarse al proceso. Si servidor 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 se proporciona 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 de DEBUG_CREATE_PROCESS_OPTIONS.

Valor devuelto

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

Código devuelto Descripción
S_OK
El método se realizó correctamente.

Observaciones

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 asocia al proceso recién creado. Este comportamiento es similar al de CreateProcessAndAttach2 cuando su argumento ProcessId está establecido en cero.

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

Requisitos

Requisito Valor
de la plataforma de destino de Escritorio
encabezado de dbgeng.h (include Dbgeng.h)

Consulte también

.create (Crear proceso)

AttachProcess

ConnectProcessServer

CreateProcess2

CreateProcessAndAttach2

IDebugClient3

IDebugClient4

IDebugClient5