Méthode IMsRdpClient::SetVirtualChannelOptions

  • Article

Définit les options de canal virtuel pour le contrôle ActiveX Bureau à distance.

Appelez cette méthode après avoir appelé la méthode CreateVirtualChannels , mais avant d’établir une connexion avec la méthode Connect . Cette méthode définit des options supplémentaires sur les canaux virtuels qui ont été créés avec CreateVirtualChannels.

Syntaxe

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

Paramètres

ChanName [in]

Nom du canal virtuel spécifié dans l’appel à la méthode CreateVirtualChannels .

chanOptions [in]

Options à définir pour le canal virtuel spécifié par le paramètre ChanName . Pour obtenir une description des options possibles, consultez CHANNEL_DEF. Pour plus d'informations, consultez la section Notes qui suit.

Valeur renvoyée

Retournez S_OK en cas de réussite.

Notes

Un exemple d’utilisation de cette méthode consiste à déclarer le canal en tant que contrôle à distance persistant en définissant l’indicateur CHANNEL_OPTION_REMOTE_CONTROL_PERSISTENT . Cela signifie que le canal n’est pas fermé lorsqu’une commande à distance se connecte au client ou se déconnecte de la session connectée au client. Pour plus d’informations, consultez Canaux virtuels persistants de contrôle à distance.

Pour plus d’informations sur la connexion Web Bureau à distance, consultez Configuration requise pour la connexion Web Bureau à distance.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
 Windows Vista
Serveur minimal pris en charge
 Windows Server 2008
Bibliothèque de types
MsTscAx.dll
DLL
MsTscAx.dll
IID
 IID_IMsRdpClient est défini comme 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Voir aussi

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

CHANNEL_DEF

CreateVirtualChannels

GetVirtualChannelOptions