.endsrv (デバッグ サーバーの終了)

.endsrv コマンドを使用すると、デバッガーはアクティブなデバッグ サーバーをキャンセルします。

.endsrv ServerID 

パラメーター

ServerID
デバッグサーバーのIDを指定します。

Environment

このコマンドは、デバッガーを介してリモート デバッグを実行している場合にのみ使用できます。

追加情報

リモート デバッグの詳細については、「デバッガーを使用したリモート デバッグ」を参照してください。

解説

.endsrv コマンドは、デバッグ サーバー、またはデバッグ サーバーに接続されているデバッグ クライアントの 1 つから発行する必要があります。

デバッグ サーバーの ID を確認するには、.servers (デバッグ サーバーのリスト) コマンドを使用します。

.endsrv コマンドはデバッグ サーバーを終了できますが、プロセス サーバーまたは KD 接続サーバーを終了することはできません。 これらのサーバーを終了する方法については、「プロセス サーバー セッションの制御」および「KD 接続サーバー セッションの制御」を参照してください。 (ただし、.endsrv がプログラムで起動されたプロセス サーバーを終了できる例外的なケースが 1 つあります。詳細については、IDebugClient::StartProcessServer を参照してください。)

デバッグ サーバーをキャンセルすると、今後デバッグ クライアントがサーバーに接続できなくなります。 ただし、デバッグ サーバーをキャンセルしても、現在サーバー経由で接続されているクライアントは切断されません。

以下のような状況を考えてください。 次の例に示すように、いくつかのデバッグ サーバーを起動するとします。

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

次に、次の例に示すように、パスワードを使用することにします。

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

ただし、以前のサーバーはまだ実行されているため、次の例に示すように、それらをキャンセルする必要があります。

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

最後に、以前のサーバーがアクティブだったときにコンピューターに何も接続されていないことを確認するには、.clients (デバッグ クライアントのリスト) コマンドを使用します。

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

注意 TCP、NPIPE、または COM プロトコルでパスワードを使用すると、パスワードは暗号化されないため、わずかな保護しか提供されません。 パスワードを SSL または SPIPE プロトコルと一緒に使用すると、パスワードは暗号化されます。 安全なリモート セッションを確立したい場合は、SSL または SPIPE プロトコルを使用する必要があります。