Compartir a través de

ICorDebug::CreateProcess (Método)

  • Artículo

Inicia un proceso y su subproceso principal bajo el control del depurador.

Sintaxis

HRESULT CreateProcess (  
    [in]  LPCWSTR                     lpApplicationName,  
    [in]  LPWSTR                      lpCommandLine,  
    [in]  LPSECURITY_ATTRIBUTES       lpProcessAttributes,  
    [in]  LPSECURITY_ATTRIBUTES       lpThreadAttributes,  
    [in]  BOOL                        bInheritHandles,  
    [in]  DWORD                       dwCreationFlags,  
    [in]  PVOID                       lpEnvironment,  
    [in]  LPCWSTR                     lpCurrentDirectory,  
    [in]  LPSTARTUPINFOW              lpStartupInfo,  
    [in]  LPPROCESS_INFORMATION       lpProcessInformation,  
    [in]  CorDebugCreateProcessFlags  debuggingFlags,  
    [out] ICorDebugProcess            **ppProcess  
);

Parámetros

lpApplicationName
[in] Puntero a una cadena terminada en null que especifica el módulo que va a ejecutar el proceso iniciado. El módulo se ejecuta en el contexto de seguridad del proceso de llamada.

lpCommandLine
[in] Puntero a una cadena terminada en null que especifica la línea de comandos que ejecutará el proceso iniciado. El nombre de la aplicación (por ejemplo, "SomeApp.exe") debe ser el primer argumento.

lpProcessAttributes
[in] Puntero a una estructura Win32 SECURITY_ATTRIBUTES que especifica el descriptor de seguridad para el proceso. Si lpProcessAttributes es null, el proceso obtiene un descriptor de seguridad predeterminado.

lpThreadAttributes
[in] Puntero a una estructura Win32 SECURITY_ATTRIBUTES que especifica el descriptor de seguridad para subproceso principal del proceso. Si lpThreadAttributes es null, el subproceso obtiene un descriptor de seguridad predeterminado.

bInheritHandles
[in] Establézcalo en true para indicar que el proceso iniciado hereda cada manipulador heredable del proceso de llamada, o en false para indicar que los manipuladores no se heredan. Los manipuladores heredados tienen el mismo valor y derechos de acceso que los manipuladores originales.

dwCreationFlags
[in] Una combinación bit a bit de las marcas de creación de procesos de Win32 que controlan la clase de prioridad y el comportamiento del proceso iniciado.

lpEnvironment
[in] Puntero a un bloque de entorno para el nuevo proceso.

lpCurrentDirectory
[in] Puntero a una cadena terminada en null que especifica la ruta de acceso completa al directorio actual para el proceso. Si este parámetro es null, el nuevo proceso tendrá la misma unidad y directorio actuales que el proceso de llamada.

lpStartupInfo
[in] Puntero a una estructura Win32 STARTUPINFOW que especifica la estación de ventana, el escritorio, los manipuladores estándar y la apariencia de la ventana principal para el proceso iniciado.

lpProcessInformation
[in] Puntero a una estructura Win32 PROCESS_INFORMATION que especifica la información de identificación sobre el proceso que se va a iniciar.

debuggingFlags
[in] Un valor de la enumeración CorDebugCreateProcessFlags que especifica las opciones de depuración.

ppProcess
[out] Un puntero a la dirección de un objeto ICorDebugProcess que representa el proceso.

Comentarios

Los parámetros de este método son los mismos que los del método de Win32 CreateProcess.

Para habilitar la depuración en modo mixto no administrado, establezca dwCreationFlags en DEBUG_PROCESS | DEBUG_ONLY_THIS_PROCESS. Si solo desea usar la depuración administrada, no establezca estas marcas.

Si el depurador y el proceso que se va a depurar (el proceso asociado) comparten una sola consola y, si se usa la depuración de interoperabilidad, es posible que el proceso asociado mantenga bloqueos de consola y se detenga en un evento de depuración. A continuación, el depurador bloqueará cualquier intento de usar la consola. Para evitar este problema, establezca la marca CREATE_NEW_CONSOLE en el parámetro dwCreationFlags.

La depuración de interoperabilidad no se admite en plataformas Win9x y no x86, como en plataformas basadas en IA-64 y AMD64.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versiones de .NET Framework: está disponible desde la versión 1.0

Consulte también