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

O método CreateProcessWide cria um processo a partir da linha de comando especificada.

Sintaxe

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

Parâmetros

[in] Server

Especifica o servidor de processo a ser usado ao anexar ao processo. Se o servidor 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. O método CreateProcessWide pode modificar o conteúdo da cadeia de caracteres que você fornece neste parâmetro. Portanto, esse parâmetro não pode ser um ponteiro para memória somente leitura (como uma variável const ou uma cadeia de caracteres literal). Passar uma cadeia de caracteres constante nesse parâmetro pode levar a uma violação de acesso.

[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 .

Valor retornado

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. Esse comportamento é semelhante ao de CreateProcessAndAttach2 quando 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.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (include Dbgeng.h)

Confira também

.create (Criar Processo)

AttachProcess

ConnectProcessServer

CreateProcess2

CreateProcessAndAttach2

IDebugClient3

IDebugClient4

IDebugClient5