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