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

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

.endsrv ServerID 

パラメーター

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

環境

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

アイテム	説明
モード	ユーザー モードのみ
目標値	ライブ、クラッシュ ダンプ
プラットフォーム	すべて

追加情報

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

解説

.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 プロトコルを使用する必要があります。