.endsrv (Encerrar Servidor de Depuração)
O comando .endsrv faz com que o depurador cancele um servidor de depuração ativo.
.endsrv ServerID
Parâmetros
ID do servidor
Especifica a ID do servidor de depuração.
Ambiente
Você pode usar esse comando somente quando estiver executando a depuração remota por meio do depurador.
| Item | Descrição |
|---|---|
| Modos | Somente modo de usuário |
| Destinos | Ao vivo, despejo de memória |
| Plataformas | Tudo |
Informações Adicionais
Para obter mais informações sobre depuração remota, consulte Depuração remota por meio do depurador.
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 .servers (Listar Servidores de Depuração).
O comando .endsrv pode encerrar um servidor de depuração, mas não pode encerrar um servidor de processo ou servidor de conexão KD. Para obter informações sobre como encerrar esses servidores, consulte Controlando uma sessão do servidor de processo e Controlando uma sessão do servidor de conexão KD. (Há, no entanto, um caso excepcional 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 conectado no momento por meio 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=hardtoguess
Server started with 'npipe:pipe=tiger,password=hardtoguess'
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 esteja conectado ao seu computador enquanto os servidores anteriores estiverem ativos, use o comando .clients (Listar clientes de depuração).
0:000> .clients
HotMachine\HostUser, last active Mon Mar 04 16:05:21 2002
Cuidado O uso de uma senha com protocolo TCP, NPIPE ou COM oferece apenas uma pequena quantidade de proteção, pois a senha não é criptografada. Quando você usa uma senha junto com um protocolo SSL ou STPIPE, a senha é criptografada. Se você deseja estabelecer uma sessão remota segura, deve usar o protocolo SSL ou STPIPE.