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

Artigo
02/23/2024

O método CreateProcess cria um processo da linha de comando especificada.

Sintaxe

HRESULT CreateProcess(
  [in] ULONG64 Server,
  [in] PSTR    CommandLine,
  [in] ULONG   CreateFlags
);

Parâmetros

[in] Server

Especifica o servidor de processo a ser usado para anexar ao processo. Se Server for zero, o mecanismo criará um processo local sem usar um servidor de processo.

[in] CommandLine

Especifica a linha de comando a ser executada para criar o novo processo.

[in] CreateFlags

Especifica os sinalizadores a serem usados ao criar o processo. Para obter detalhes sobre esses sinalizadores, consulte o membro CreateFlags da estrutura DEBUG_CREATE_PROCESS_OPTIONS .

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

Esse método está disponível apenas para depuração dinâmica do modo de usuário.

Se CreateFlags contiver um dos sinalizadores DEBUG_PROCESS ou DEBUG_ONLY_THIS_PROCESS, o mecanismo também será anexado ao processo recém-criado; isso é semelhante ao comportamento de CreateProcessAndAttach2 com seu argumento ProcessId definido como zero.

Para obter mais informações sobre como criar e anexar a destinos dinâmicos do modo de usuário, consulte Destinos do Live User-Mode.