如何在MFC C++应用中使用ActiveX RDP客户端并实现状态与错误检测？

问题描述 #

找不到ActiveX RDP客户端的可用使用示例，虽找到微软文档《Using the Remote Desktop ActiveX control》，但未说明具体用法。已实现连接，但由于多数方法返回void，不知如何获取错误码、验证连接成功、检测断开等。

当前无错误检查的连接代码如下：

CMsRdpClientAdvancedSettings8 advancedSettings = m_ocx.get_AdvancedSettings6();

m_ocx.put_Server (L"192.168.1.2"); // 目标IP
m_ocx.put_UserName (L"user"); // 用户名
m_ocx.put_Domain(L"pc1");
m_ocx.put_DesktopHeight (768); // 分辨率高度
m_ocx.put_DesktopWidth (1024); // 分辨率宽度
advancedSettings.put_SmartSizing (TRUE); // 控件自适应缩放远程桌面
advancedSettings.put_AuthenticationLevel(2);
advancedSettings.put_EnableCredSspSupport(TRUE);
m_ocx.put_ColorDepth(32);
m_ocx.put_DisconnectedText(_T("已断开连接"));
m_ocx.put_ConnectingText (_T ( "请稍候...")); // 连接时显示的文本
m_ocx.Connect();

解决方案 #

1. 利用事件回调捕获状态与错误 #

Remote Desktop ActiveX控件通过事件通知传递状态变化和错误信息，需为控件绑定以下关键事件的处理函数：

• OnConnected：触发时表示连接成功建立
• OnDisconnected：连接断开时触发，参数disconnectReason为断开原因码
• OnLoginError：登录出错时触发，参数errorCode和errorMessage返回具体错误详情
• OnConnecting：开始连接时触发，可用于更新UI状态

在MFC环境中，通过类向导为CMsRdpClientX控件添加事件处理函数示例：

void CYourDialog::OnConnected()
{
    // 连接成功后的逻辑，如隐藏加载提示
}

void CYourDialog::OnDisconnected(long disconnectReason)
{
    CString reason;
    switch(disconnectReason)
    {
        case 0: reason = _T("正常断开连接"); break;
        case 1: reason = _T("服务器拒绝连接"); break;
        case 2: reason = _T("网络连接错误"); break;
        default: reason.Format(_T("未知错误，代码：%ld"), disconnectReason); break;
    }
    MessageBox(reason, _T("连接断开"));
}

void CYourDialog::OnLoginError(long errorCode, BSTR errorMessage)
{
    CString errMsg(errorMessage);
    MessageBox(_T("登录失败：") + errMsg, _T("错误"), MB_ICONERROR);
}

2. 主动获取当前连接状态 #

通过控件的Connected属性实时查询连接状态：

VARIANT_BOOL isConnected = m_ocx.get_Connected();
if (isConnected == VARIANT_TRUE)
{
    // 当前处于连接状态
}
else
{
    // 未连接或已断开
}

3. 获取最近错误信息 #

通过AdvancedSettings的LastError属性获取最近一次操作的错误代码：

long lastError = advancedSettings.get_LastError();
if (lastError != 0)
{
    // 非0值表示存在错误，可根据代码查询对应含义
}

补充说明 #

微软文档虽未提供完整示例，但事件驱动是ActiveX控件的标准交互逻辑，所有状态变化和错误都会通过事件传递。确保绑定控件时正确关联事件处理函数，否则无法接收状态通知。

内容的提问来源于stack exchange，提问作者user3161924