.endsrv (End Debugging Server)
Der befehl .endsrv bewirkt, dass der Debugger einen aktiven Debugserver abbricht.
.endsrv ServerID
Parameter
ServerID-
Gibt die ID des Debugservers an.
Umwelt
Sie können diesen Befehl nur verwenden, wenn Sie das Remotedebugging über den Debugger ausführen.
| Artikel | Beschreibung |
|---|---|
| Modi | Nur Benutzermodus |
| Ziele | Live, Absturzabbild |
| Plattformen | Alle |
Zusatzinformation
Weitere Informationen zum Remotedebugging finden Sie unter Remotedebugging über den Debugger.
Wichtig
Bei der Verwendung des Remotedebuggings gibt es wichtige Sicherheitsaspekte. Weitere Informationen, einschließlich Informationen zum Aktivieren des sicheren Modus, finden Sie unter Sicherheitsüberlegungen für Windows-Debugtools.
Bemerkungen
Sie müssen den Befehl .endsrv vom Debugserver oder von einem der Debugclients ausgeben, die mit dem Debugserver verbunden sind.
Um die ID eines Debugservers zu ermitteln, verwenden Sie den Befehl .servers (Listendebuggingserver).
Der befehl .endsrv kann einen Debugserver beenden, aber er kann keinen Prozessserver oder KD-Verbindungsserver beenden. Informationen zum Beenden dieser Server finden Sie unter Steuern einer Prozessserversitzung und Steuern einer KD-Verbindungsserversitzung. (Es gibt jedoch einen Ausnahmefall, wenn .endsrv einen Prozessserver beenden kann, der programmgesteuert gestartet wurde. Ausführliche Informationen finden Sie unter IDebugClient::StartProcessServer.)
Wenn Sie einen Debugserver abbrechen, verhindern Sie, dass zukünftige Debugclients an den Server angefügt werden. Wenn Sie jedoch einen Debugserver abbrechen, trennen Sie keine Clients, die derzeit über den Server angefügt sind.
Berücksichtigen Sie die folgende Situation. Angenommen, Sie starten einige Debugserver, wie das folgende Beispiel zeigt.
0:000> .server npipe:pipe=rabbit
Server started with 'npipe:pipe=rabbit'
0:000> .server tcp:port=7
Server started with 'tcp:port=7'
Anschließend entscheiden Sie sich für die Verwendung eines Kennworts, wie im folgenden Beispiel gezeigt.
0:000> .server npipe:pipe=tiger,password=Password
Server started with 'npipe:pipe=tiger,password=Password'
Die früheren Server werden jedoch weiterhin ausgeführt, daher sollten Sie sie abbrechen, wie im folgenden Beispiel gezeigt.
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=*
Um sicherzustellen, dass nichts an Ihren Computer angefügt ist, während die früheren Server aktiv waren, verwenden Sie den Befehl .clients (List Debugging Clients) Befehl.
0:000> .clients
HotMachine\HostUser, last active Mon Mar 04 16:05:21 2002
Wichtig
Die Verwendung eines Kennworts mit TCP, NPIPE oder COM-Protokoll bietet nur einen geringen Schutz, da das Kennwort nicht verschlüsselt ist. Wenn Sie ein Kennwort zusammen mit einem SSL- oder SPIPE-Protokoll verwenden, wird das Kennwort verschlüsselt. Wenn Sie eine sichere Remotesitzung einrichten möchten, müssen Sie das SSL- oder SPIPE-Protokoll verwenden.