.endsrv (结束调试服务器)

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

.endsrv ServerID 

参数

ServerID
指定调试服务器的 ID。

环境

只有在通过调试器执行远程调试时,才能使用此命令。

项目 描述
模式 仅限用户模式
目标 实时故障转储
平台

其他信息

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

重要

使用远程调试时,有一些重要的安全注意事项。 有关详细信息,包括有关启用安全模式的信息,请参阅 windows 调试工具安全注意事项。

言论

必须从调试服务器或连接到调试服务器的某个调试客户端发出 .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=Password
Server started with 'npipe:pipe=tiger,password=Password'

但前面的服务器仍在运行,因此应取消它们,如以下示例所示。

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