Partilhar via


Método IMsRdpClient::SetVirtualChannelOptions

Define as opções de canal virtual para o controle ActiveX da Área de Trabalho Remota.

Chame esse método depois de chamar o método CreateVirtualChannels , mas antes de estabelecer uma conexão com o método Connect . Esse método define opções adicionais em canais virtuais que foram criados com CreateVirtualChannels.

Sintaxe

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

Parâmetros

ChanName [in]

O nome do canal virtual especificado na chamada para o método CreateVirtualChannels .

chanOptions [in]

As opções a serem definidas para o canal virtual especificado pelo parâmetro ChanName . Para obter uma descrição das opções possíveis, consulte CHANNEL_DEF. Para obter mais informações, consulte a seção Comentários a seguir.

Retornar valor

Retorne S_OK se tiver êxito.

Comentários

Um exemplo de como usar esse método seria declarar o canal como controle remoto persistente definindo o sinalizador CHANNEL_OPTION_REMOTE_CONTROL_PERSISTENT . Isso significa que o canal não seria fechado quando um controle remoto se conectasse ou se desconectasse da sessão conectada ao cliente. Para obter mais informações, consulte Canais virtuais persistentes de controle remoto.

Para obter mais informações sobre a Conexão da Web da Área de Trabalho Remota, consulte Requisitos para conexão da Web da Área de Trabalho Remota.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Biblioteca de tipos
MsTscAx.dll
DLL
MsTscAx.dll
IID
IID_IMsRdpClient é definido como 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Confira também

Imsrdpclient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

CHANNEL_DEF

CreateVirtualChannels

GetVirtualChannelOptions