.endsrv (Enddebuggingserver)

  • Artikel

Der Befehl .endsrv 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 remotedebuggen über den Debugger ausführen.

Element BESCHREIBUNG
Modi Nur Benutzermodus
Targets Liveabbild, Absturzabbild
Plattformen All

Zusätzliche Informationen

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

Hinweise

Sie müssen den Befehl .endsrv vom Debugserver oder von einem der Debugclients ausstellen, die mit dem Debugserver verbunden sind.

Um die ID eines Debugservers zu ermitteln, verwenden Sie den Befehl SERVER (Debugserver auflisten).

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, in dem .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.

Betrachten 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 das folgende Beispiel zeigt.

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 wurde, während die früheren Server aktiv waren, verwenden Sie den Befehl CLIENTS (Debugclients auflisten).

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

Vorsicht Die Verwendung eines Kennworts mit DEM 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.