.endsrv (Debugging-Server beenden)

Der .endsrv-Befehl bewirkt, dass der Debugger einen aktiven Debugserver abbricht.

.endsrv ServerID 

Parameter

ServerID
Gibt die ID des Debugservers an.

Environment

Sie können diesen Befehl nur verwenden, wenn Sie das Remotedebugging über den Debugger ausführen.

Artikel	Beschreibung
Modi	Nur Benutzermodus
Targets	Live, Crash Dump
Plattformen	Alle

Zusätzliche Informationen

Weitere Informationen zum Remotedebugging finden Sie unter Remotedebugging über den Debugger.

Hinweise

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 .endsrv-Befehl 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. Weitere 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=hardtoguess
Server started with 'npipe:pipe=tiger,password=hardtoguess'

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 an Ihren Computer nichts angefügt wurde, während die früheren Server aktiv waren, verwenden Sie den Befehl .clients (Listendebuggingclients).

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

Achtung : 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.