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

Artigo
02/23/2024

O método CreateProcessWide cria um processo 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 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. O método CreateProcessWide pode modificar o conteúdo da cadeia de caracteres que você fornece nesse 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 .

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