.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 协议。