IMsTscAxEvents：：OnAutoReconnecting 方法

当客户端在与远程桌面会话主机 (RD 会话主机) 服务器自动重新连接会话时调用。

语法

void OnAutoReconnecting(
  [in]  LONG                       disconnectReason,
  [in]  LONG                       attemptCount,
  [out] AutoReconnectContinueState *pArcContinueStatus
);

parameters

disconnectReason [in]

描述上次会话断开连接原因的代码。

attemptCount [in]

在当前自动重新连接过程中进行的尝试次数。 每次尝试时，此计数都会增加一个。

pArcContinueStatus [out]

指向指定自动重新连接过程状态的返回代码的指针。 可以重置此代码以更改当前自动重新连接过程的状态。

有关重置此代码的详细信息，请参阅“备注”部分。

autoReconnectContinueAutomatic (0)

重新连接过程会自动发生。 这是默认值。

autoReconnectContinueStop (1)

重新连接过程已停止。

autoReconnectContinueManual (2)

正在手动执行重新连接过程。

返回值

此方法不返回值。

注解

在事件接收器中实现此方法，以接收该控件正在重新建立与 RD 会话主机服务器的连接的通知。

通过将 pArcContinueStatus 参数的值设置为 autoReconnectContinueAutomatic 来更改自动重新连接过程的状态时，此方法以纯咨询模式运行。 容器可以侦听此事件，以获取自动重新连接过程正在处理的通知。 该控件将根据自己的内部计时和尝试计数自动重新建立连接。 在每次自动重新连接尝试期间调用此方法，以便通知容器。

通过将 pArcContinueStatus 参数的值设置为 autoReconnectContinueStop 来更改自动重新连接过程的状态时，将终止当前的自动重新连接尝试，将断开连接通知发送到容器，不会发出进一步的自动重新连接通知。

注意

使用 EnableAutoReconnect 属性启用或禁用自动重新连接。

通过将 pArcContinueStatus 参数的值设置为 autoReconnectContinueManual 来更改自动重新连接进程的状态时，容器将通过调用连接来触发连接尝试或断开连接来取消自动重新连接进程来手动控制自动重新连接过程。 设置为此值后，控件将停止自动重新连接尝试，并且它将成为容器的策略，以发出连接调用以触发自动重新连接尝试。 当容器为自动重新连接提供自定义 UI 行为（例如，在自动重新连接过程之前重启已删除的 RAS 或 VPN 连接）时，将完成此操作。

有关远程桌面 Web 连接的详细信息，请参阅 远程桌面 Web 连接的要求。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
类型库	MsTscAx.dll
DLL	MsTscAx.dll

另请参阅

IMsTscAxEvents