Méthode IMsRdpClient::SetVirtualChannelOptions
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 |
|
| DLL |
|
| IID |
IID_IMsRdpClient est défini comme 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |