Método IDebugClient5::StartProcessServer (dbgeng.h)

Artigo
02/23/2024

O método StartProcessServer inicia um servidor de processo.

Sintaxe

HRESULT StartProcessServer(
  [in]           ULONG Flags,
  [in]           PCSTR Options,
  [in, optional] PVOID Reserved
);

Parâmetros

[in] Flags

Especifica a classe dos destinos que estarão disponíveis por meio do servidor de processo. Isso deve ser definido como DEBUG_CLASS_USER_WINDOWS.

[in] Options

Especifica as opções de conexões para esse servidor de processo. Essas são as mesmas opções dadas à opção -t da linha de comando DbgSrv. Para obter detalhes sobre a sintaxe dessa cadeia de caracteres, consulte Ativando um servidor de processo.

[in, optional] Reserved

Defina como NULL.

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

O servidor de processo iniciado será acessível por clientes remotos por meio do transporte especificado no parâmetro Options .

Para interromper o servidor de processo do cliente inteligente, use o método EndProcessServer . Para desligar o servidor de processo do computador em que ele está sendo executado, use o Gerenciador de Tarefas para encerrar o processo. Se a instância do mecanismo de depurador que usou StartProcessServer ainda estiver em execução, ela poderá usar Execute para emitir o comando de depurador .endsrv 0, que encerrará o servidor de processo (isso é uma exceção ao comportamento usual de .endsrv, que geralmente não afeta os servidores de processo).

Para obter mais informações sobre servidores de processo e depuração remota, consulte Servidores de Processo, Servidores de Conexão do Kernel e Clientes Inteligentes.