.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

Id_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 a 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 um 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. (No entanto, há 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 desanexe nenhum cliente que esteja anexado 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=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 anexado ao computador enquanto os servidores anteriores estavam 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 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.