IMsRdpClient::SetVirtualChannelOptions 方法

设置远程桌面 ActiveX 控件的虚拟通道选项。

在调用 CreateVirtualChannels 方法之后,但在与 Connect 方法建立连接之前调用此方法。 此方法在已使用 CreateVirtualChannels 创建的虚拟通道上设置其他选项。

语法

HRESULT SetVirtualChannelOptions(
  [in] BSTR ChanName,
  [in] LONG chanOptions
);

参数

ChanName [in]

在调用 CreateVirtualChannels 方法时指定的虚拟通道的名称。

chanOptions [in]

要为 ChanName 参数指定的虚拟通道设置的选项。 有关可能选项的说明,请参阅 CHANNEL_DEF。 有关更多信息,请参见下面的“备注”部分。

返回值

如果成功,则返回 S_OK

注解

使用此方法的一个示例是通过设置 CHANNEL_OPTION_REMOTE_CONTROL_PERSISTENT 标志将通道声明为远程控制持久性。 这意味着,当远程控制连接到客户端的会话或断开连接时,通道不会关闭。 有关详细信息,请参阅 远程控制持久虚拟通道

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

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
类型库
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsRdpClient定义为 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

请参阅

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

CHANNEL_DEF

CreateVirtualChannels

GetVirtualChannelOptions