.endsrv(结束调试服务器)

.endsrv 命令会导致调试器取消活动调试服务器。

.endsrv ServerID 

参数

ServerID
指定调试服务器的 ID。

环境

仅当通过调试器执行远程调试时,才能使用此命令。

说明
模式 仅限用户模式
目标 实时、故障转储
平台 全部

其他信息

有关远程调试的详细信息,请参阅 通过调试器进行远程调试

注解

必须从调试服务器或连接到调试服务器的某个调试客户端发出 .endsrv 命令。

若要确定调试服务器的 ID,请使用 .servers (列出调试服务器) 命令。

.endsrv 命令可以终止调试服务器,但不能终止进程服务器或 KD 连接服务器。 有关如何结束这些服务器的信息,请参阅 控制进程服务器会话 和控制 KD 连接服务器会话。 (但是,存在一种例外情况,即 .endrv 可以终止以编程方式启动的进程服务器;有关详细信息,请参阅 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 协议。