Método ICorDebug::CreateProcess

Inicia um processo e seu thread primário sob o controle do depurador.

Sintaxe

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 [em] Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o módulo a ser executado pelo processo iniciado. O módulo é executado no contexto de segurança do processo de chamada.

lpCommandLine [em] Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a linha de comando a ser executada pelo processo iniciado. O nome do aplicativo (por exemplo, "SomeApp.exe") deve ser o primeiro argumento.

lpProcessAttributes [em] Ponteiro para uma estrutura Win32 SECURITY_ATTRIBUTES que especifica o descritor de segurança para o processo. Se lpProcessAttributes for null, o processo obtém um descritor de segurança padrão.

lpThreadAttributes [em] Ponteiro para uma estrutura Win32 SECURITY_ATTRIBUTES que especifica o descritor de segurança para o thread primário do processo. Se lpThreadAttributes for null, o thread obtém um descritor de segurança padrão.

bInheritHandles [em] Defina como true para indicar que cada identificador herdado no processo de chamada é herdado pelo processo iniciado ou false para indicar que os identificadores não são herdados. As alças herdadas têm o mesmo valor e direitos de acesso que as alças originais.

dwCreationFlags [em] Uma combinação bit a bit dos sinalizadores de criação de processo Win32 que controlam a classe de prioridade e o comportamento do processo iniciado.

lpEnvironment [em] Ponteiro para um bloco de ambiente para o novo processo.

lpCurrentDirectory [em] Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o caminho completo para o diretório atual do processo. Se esse parâmetro for null, o novo processo terá a mesma unidade e diretório atuais que o processo de chamada.

lpStartupInfo [em] Ponteiro para uma estrutura Win32 STARTUPINFOW que especifica a estação da janela, área de trabalho, identificadores padrão e aparência da janela principal para o processo iniciado.

lpProcessInformation [em] Ponteiro para uma estrutura Win32 PROCESS_INFORMATION que especifica as informações de identificação sobre o processo a ser iniciado.

debuggingFlags [em] Um valor da enumeração CorDebugCreateProcessFlags que especifica as opções de depuração.

ppProcess [saídas] Um ponteiro para o endereço de um ICorDebugProcess objeto que representa o processo.

Observações

Os parâmetros deste método são os mesmos que os do método Win32 CreateProcess .

Para habilitar a depuração de modo misto não gerenciado, defina dwCreationFlags como DEBUG_PROCESS | DEBUG_ONLY_THIS_PROCESS. Se você quiser usar apenas depuração gerenciada, não defina esses sinalizadores.

Se o depurador e o processo a ser depurado (o processo anexado) compartilharem um único console, e se a depuração de interoperabilidade for usada, é possível que o processo anexado mantenha bloqueios de console e pare em um evento de depuração. O depurador bloqueará qualquer tentativa de usar o console. Para evitar esse problema, defina o sinalizador CREATE_NEW_CONSOLE no dwCreationFlags parâmetro.

A depuração de interoperabilidade não é suportada em plataformas Win9x e não x86, como plataformas baseadas em IA-64 e AMD64.

Requerimentos

Plataformas: Consulte Sistemas operacionais suportados pelo .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões .NET: Disponível desde o .NET Framework 1.0

Consulte também

• ICorDebug Interface