Método IMsRdpClient::SetVirtualChannelOptions

Establece las opciones de canal virtual para el control ActiveX de Escritorio remoto.

Llame a este método después de llamar al método CreateVirtualChannels , pero antes de establecer una conexión con el método Connect . Este método establece opciones adicionales en canales virtuales que se han creado con CreateVirtualChannels.

Sintaxis

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

Parámetros

ChanName [in]

Nombre del canal virtual especificado en la llamada al método CreateVirtualChannels .

chanOptions [in]

Las opciones que se van a establecer para el canal virtual especificado por el parámetro ChanName . Para obtener una descripción de las posibles opciones, consulte CHANNEL_DEF. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Valor devuelto

Devuelve S_OK si se ejecuta correctamente.

Comentarios

Un ejemplo de uso de este método sería declarar el canal como control remoto persistente estableciendo la marca CHANNEL_OPTION_REMOTE_CONTROL_PERSISTENT . Esto significa que el canal no se cerraría cuando un control remoto se conecta o se desconecta de la sesión conectada al cliente. Para obtener más información, vea Canales virtuales persistentes de control remoto.

Para obtener más información sobre la conexión web de Escritorio remoto, vea Requisitos para la conexión web de Escritorio remoto.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Biblioteca de tipos
MsTscAx.dll
Archivo DLL
MsTscAx.dll
IID
IID_IMsRdpClient se define como 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Consulte también

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

CHANNEL_DEF

CreateVirtualChannels

GetVirtualChannelOptions