.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.
Meio Ambiente
Você pode usar esse comando somente quando estiver executando a depuração remota através do depurador.
| Número | Descrição |
|---|---|
| Modos | Apenas no modo de utilizador |
| Objetivos | Ao vivo, despejo de memória |
| Plataformas | Tudo |
Informação Adicional
Para obter mais informações sobre depuração remota, consulte Depuração remota através do 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.
Comentários
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 uma sessão do Process Server e Controlando uma sessão do KD Connection Server. (Há, no entanto, um caso excecional em que .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 clientes de depuração futuros sejam anexados ao servidor. No entanto, se você cancelar um servidor de depuração, não desanexará nenhum cliente que esteja atualmente conectado através do servidor.
Considere a seguinte situação. 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, então 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=*
Finalmente, para certificar-se de que nada conectado ao seu computador enquanto os servidores anteriores estavam ativos, use o comando
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, porque a senha não é criptografada. Quando utiliza uma palavra-passe juntamente com um protocolo SSL ou SPIPE, a palavra-passe é encriptada. Se você quiser estabelecer uma sessão remota segura, você deve usar o protocolo SSL ou SPIPE .