Compartilhar via


Método IDebugClient4::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 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 CreateFlags membro da estrutura de DEBUG_CREATE_PROCESS_OPTIONS.

Valor de retorno

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

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

Observações

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 de modo de usuário dinâmico, consulte de Destinos do Live User-Mode .

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

.create (Criar Processo)

do AttachProcess

ConnectProcessServer

CreateProcess2

CreateProcessAndAttach2

IDebugClient3

IDebugClient4

IDebugClient5