.endsrv (Servidor de depuración final)
El comando .endsrv hace que el depurador cancele un servidor de depuración activo.
.endsrv ServerID
Parámetros
ServerID
Especifica el identificador del servidor de depuración.
Entorno
Puede usar este comando solo cuando se realiza la depuración remota a través del depurador.
| Elemento | Descripción |
|---|---|
| Modos | Solo modo de usuario |
| Destinos | En tiempo real, volcado de errores |
| Platforms | All |
Información adicional
Para obtener más información sobre la depuración remota, vea Depuración remota a través del depurador.
Comentarios
Debe emitir el comando .endsrv desde el servidor de depuración o desde uno de los clientes de depuración que están conectados al servidor de depuración.
Para determinar el identificador de un servidor de depuración, use el comando .servers (Enumerar servidores de depuración).
El comando .endsrv puede finalizar un servidor de depuración, pero no puede finalizar un servidor de procesos o un servidor de conexión KD. Para obtener información sobre cómo finalizar estos servidores, consulte Control de una sesión del servidor de procesos y Control de una sesión de servidor de conexión KD. (Sin embargo, hay un caso excepcional cuando .endsrv puede finalizar un servidor de procesos que se ha iniciado mediante programación; para obtener más información, vea IDebugClient::StartProcessServer).
Si cancela un servidor de depuración, impide que los clientes de depuración futuros se conecten al servidor. Sin embargo, si cancela un servidor de depuración, no desasocia ningún cliente que esté conectado actualmente a través del servidor.
Tenga en cuenta la siguiente situación. Supongamos que inicia algunos servidores de depuración, como se muestra en el ejemplo siguiente.
0:000> .server npipe:pipe=rabbit
Server started with 'npipe:pipe=rabbit'
0:000> .server tcp:port=7
Server started with 'tcp:port=7'
A continuación, decide usar una contraseña, como se muestra en el ejemplo siguiente.
0:000> .server npipe:pipe=tiger,password=hardtoguess
Server started with 'npipe:pipe=tiger,password=hardtoguess'
Pero los servidores anteriores siguen ejecutándose, por lo que debe cancelarlos, como se muestra en el ejemplo siguiente.
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 último, para asegurarse de que no hay nada asociado al equipo mientras los servidores anteriores estaban activos, use el comando .clients (Enumerar clientes de depuración).
0:000> .clients
HotMachine\HostUser, last active Mon Mar 04 16:05:21 2002
Precaución El uso de una contraseña con el protocolo TCP, NPIPE o COM solo ofrece una pequeña cantidad de protección, ya que la contraseña no está cifrada. Cuando se usa una contraseña junto con un protocolo SSL o SPIPE, la contraseña se cifra. Si desea establecer una sesión remota segura, debe usar el protocolo SSL o SPIPE.