.endsrv (fin du serveur de débogage)

La commande .endsrv entraîne l’annulation d’un serveur de débogage actif.

.endsrv ServerID 

Paramètres

ServerID
Spécifie l’ID du serveur de débogage.

Environnement

Vous ne pouvez utiliser cette commande que lorsque vous effectuez un débogage distant via le débogueur.

Informations supplémentaires

Pour plus d’informations sur le débogage à distance, consultez Débogage à distance via le débogueur.

Notes

Vous devez émettre la commande .endsrv à partir du serveur de débogage ou de l’un des clients de débogage connectés au serveur de débogage.

Pour déterminer l’ID d’un serveur de débogage, utilisez la commande .servers (List Debugging Servers).

La commande .endsrv peut arrêter un serveur de débogage, mais elle ne peut pas arrêter un serveur de processus ou un serveur de connexion KD. Pour plus d’informations sur la façon de mettre fin à ces serveurs, consultez Contrôle d’une session de serveur de processus et contrôle d’une session de serveur de connexion KD. (Toutefois, il existe un cas exceptionnel lorsque .endsrv peut mettre fin à un serveur de processus qui a été lancé par programme ; pour plus d’informations, voir IDebugClient ::StartProcessServer.)

Si vous annulez un serveur de débogage, vous empêchez les futurs clients de débogage de s’attacher au serveur. Toutefois, si vous annulez un serveur de débogage, vous ne détachez aucun client actuellement attaché via le serveur.

Tenez compte de la situation suivante. Supposons que vous démarrez certains serveurs de débogage, comme l’illustre l’exemple suivant.

0:000> .server npipe:pipe=rabbit
Server started with 'npipe:pipe=rabbit'
0:000> .server tcp:port=7
Server started with 'tcp:port=7'

Ensuite, vous décidez d’utiliser un mot de passe, comme l’illustre l’exemple suivant.

0:000> .server npipe:pipe=tiger,password=hardtoguess
Server started with 'npipe:pipe=tiger,password=hardtoguess'

Toutefois, les serveurs précédents sont toujours en cours d’exécution. Vous devez donc les annuler, comme l’illustre l’exemple suivant.

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=*

Enfin, pour vous assurer que rien n’est attaché à votre ordinateur alors que les serveurs précédents étaient actifs, utilisez la commande .clients (List Debugging Clients).

0:000> .clients
HotMachine\HostUser, last active Mon Mar 04 16:05:21 2002

Attention À l’aide d’un mot de passe avec le protocole TCP, NPIPE ou COM, il n’offre qu’une petite quantité de protection, car le mot de passe n’est pas chiffré. Lorsque vous utilisez un mot de passe avec un protocole SSL ou SPIPE, le mot de passe est chiffré. Si vous souhaitez établir une session à distance sécurisée, vous devez utiliser le protocole SSL ou SPIPE.