.endsrv (serveur de débogage final)
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.
| Article | Description |
|---|---|
| Modes | Mode utilisateur uniquement |
| Cibles | Vidage en direct et incident |
| Plates-formes | Tout |
Informations supplémentaires
Pour plus d’informations sur le débogage à distance, consultez débogage à distance via le débogueur.
Important
Il existe des considérations importantes en matière de sécurité lors de l’utilisation du débogage à distance. Pour plus d’informations, notamment sur l’activation du mode sécurisé, consultez Considérations relatives à la sécurité pour les outils de débogage Windows.
Remarques
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
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 connexions KD. (Toutefois, il existe un cas exceptionnel lorsque .endsrv peut mettre fin à un serveur de processus lancé par programmation ; pour plus d’informations, consultez 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=Password
Server started with 'npipe:pipe=tiger,password=Password'
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 pendant 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
Important
L’utilisation d’un mot de passe avec le protocole TCP, NPIPE ou COM offre uniquement 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.