激活调试客户端

  • 项目

激活调试服务器后，可以在另一台计算机上启动调试客户端，并连接到调试会话。

有两种方法可用于启动调试客户端：使用 -remote 命令行选项，或使用 WinDbg 图形界面。

客户端的协议必须与服务器的协议匹配。 用于启动调试客户端的常规语法取决于使用的协议。 存在以下选项：

Debugger -remote npipe:server=Server,pipe=PipeName[,password=Password] 

Debugger -remote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

Debugger -remote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]

若要使用图形界面连接到远程调试会话，WinDbg 必须处于休眠模式，即必须已在未使用任何命令行参数的情况下启动，或者必须已结束上一个调试会话。 选择“文件 | 连接到远程会话”菜单命令，或按 CTRL+R 快捷键。 出现“连接到远程调试器会话”对话框时，在连接字符串文本框中输入以下字符串之一：

npipe:server=Server,pipe=PipeName[,password=Password] 

tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password]

或者，可以使用“浏览”按钮找到活动调试服务器。

上述命令中的参数具有以下可能的值：

Debugger
这无需与调试客户端使用的调试器相同，即 WinDbg、KD 和 CDB 都可用于通过调试器进行远程调试。

服务器
这是在其中创建调试服务器的计算机的网络名称或 IP 地址。 两个初始反斜杠 (\) 在命令行上是可选的，但在 WinDbg 对话框中不允许使用。

pipe=PipeName
如果使用 NPIPE 或 SPIPE 协议，PipeName 是创建服务器时赋予管道的名称。

如果未使用有权访问服务器计算机的帐户登录到客户端计算机，则必须提供用户名和密码。 在客户端计算机的命令提示符窗口中输入以下命令。

net use \\Server\ipc$ /user:UserName

其中 Server 是服务器计算机的名称，UserName 是有权访问服务器计算机的帐户的名称。

出现提示时，输入 UserName 的密码。

此命令成功后，可以使用 -remote 命令行选项或使用 WinDbg 图形界面激活调试客户端。

注意 可能需要在服务器计算机上启用文件和打印机共享。 在控制面板中，导航到“网络和 Internet”>“网络和共享中心”>“高级共享设置”。 选择“启用文件和打印机共享”。

port=Socket
如果使用 TCP 或 SSL 协议，Socket 是创建服务器时使用的同一套接字端口号。

clicon
指定调试服务器将尝试通过反向连接连接到客户端。 当且仅当服务器使用的是 clicon 时，客户端才必须使用 clicon。 在大多数情况下，在使用反向连接时，会在调试服务器之前启动调试客户端。

port=COMPort
如果使用 COM 协议，COMPort 指定要使用的 COM 端口。 前缀“COM”是可选的 -- 例如，“com2”和“2”都可接受。

baud=BaudRate
如果使用 COM 协议，BaudRate 应与创建服务器时选择的波特率匹配。

channel=COMChannel
如果使用 COM 协议，COMChannel 应与创建服务器时选择的通道号匹配。

proto=Protocol
如果使用 SSL 或 SPIPE 协议，Protocol 应与创建服务器时使用的安全协议匹配。

Cert
如果使用 SSL 或 SPIPE 协议，则应使用创建服务器时使用的相同 certuser=Cert 或 machuser=Cert 参数。

password=Password
如果在创建服务器时使用了密码，则必须提供 Password，以便创建调试客户端。 它必须与原始密码匹配。 密码是区分大小写的。 如果提供的密码错误，错误消息将指定“错误 0x80004005”。密码长度必须为 12 个字符或更少。

ipversion=6
（仅适用于 Windows 调试工具 6.6.07 及更低版本）使用 TCP 连接到 Internet 时，强制调试器使用 IP 版本 6，而不是版本 4。 在 Windows Vista 和更高版本中，调试器会尝试自动默认为 IP 版本 6，因此不需要此选项。

调试客户端不能使用用于启动新调试会话的命令行选项（如 -p），只能由服务器使用。 配置选项（如 -n）将适用于客户端或服务器。