.endsrv (Servidor de Depuração Final)
O comando .endsrv faz com que o depurador cancele um servidor de depuração ativo.
.endsrv ServerID
Parâmetros
ServerID
Especifica a ID do servidor de depuração.
Ambiente
Você só pode usar esse comando quando estiver executando a depuração remota por meio do depurador.
Item | Descrição |
---|---|
Modos | Somente modo de usuário |
Alvos | Ao vivo, despejo de memória |
Plataformas | Todo |
Informações adicionais
Para obter mais informações sobre a depuração remota, consulte Depuração Remota por meio dodo depurador.
Importante
Há considerações de segurança importantes ao usar a depuração remota. Para obter mais informações, incluindo informações sobre como habilitar o modo seguro, consulte Considerações de segurança para ferramentas de depuração do Windows.
Observações
Você deve emitir o comando .endsrv do servidor de depuração ou de um dos clientes de depuração conectados ao servidor de depuração.
Para determinar a ID de um servidor de depuração, use o comando
O comando .endsrv pode encerrar um servidor de depuração, mas não pode encerrar um servidor de processo ou um servidor de conexão KD. Para obter informações sobre como encerrar esses servidores, consulte Controlando um de Sessão do Servidor de Processo e Controlando uma sessão do servidor de conexão KD. (No entanto, há um caso excepcional quando .endsrv pode encerrar um servidor de processo que foi iniciado programaticamente; para obter detalhes, consulte IDebugClient::StartProcessServer.)
Se você cancelar um servidor de depuração, impedirá que futuros clientes de depuração sejam anexados ao servidor. No entanto, se você cancelar um servidor de depuração, não desanexe nenhum cliente que esteja conectado no momento por meio do servidor.
Considere a situação a seguir. Suponha que você inicie alguns servidores de depuração, como mostra o exemplo a seguir.
0:000> .server npipe:pipe=rabbit
Server started with 'npipe:pipe=rabbit'
0:000> .server tcp:port=7
Server started with 'tcp:port=7'
Em seguida, você decide usar uma senha, como mostra o exemplo a seguir.
0:000> .server npipe:pipe=tiger,password=Password
Server started with 'npipe:pipe=tiger,password=Password'
Mas os servidores anteriores ainda estão em execução, portanto, você deve cancelá-los, como mostra o exemplo a seguir.
0:000> .servers
0 - Debugger Server - npipe:Pipe=rabbit
1 - Debugger Server - tcp:Port=7
2 - Debugger Server - npipe:Pipe=tiger,Password=*
0:000> .endsrv 0
Server told to exit. Actual exit may be delayed until
the next connection attempt.
0:000> .endsrv 1
Server told to exit. Actual exit may be delayed until
the next connection attempt.
0:000> .servers
0 - <Disabled, exit pending>
1 - <Disabled, exit pending>
2 - Debugger Server - npipe:Pipe=tiger,Password=*
Por fim, para garantir que nada anexado ao seu computador enquanto os servidores anteriores estivessem ativos, use o comando .clients (List Debugging Clients).
0:000> .clients
HotMachine\HostUser, last active Mon Mar 04 16:05:21 2002
Importante
Usar uma senha com protocolo TCP, NPIPE ou COM oferece apenas uma pequena quantidade de proteção, pois a senha não está criptografada. Quando você usa uma senha junto com um protocolo SSL ou SPIPE, a senha é criptografada. Se você quiser estabelecer uma sessão remota segura, deverá usar o protocolo SSL ou SPIPE.