IMsRdpClient :: SetVirtualChannelOptions, méthode

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

appelez cette méthode après avoir appelé la méthode CreateVirtualChannels , mais avant d’établir une connexion à l’aide de la méthode Connecter . 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 [ dans]

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

chanOptions [ dans]

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

Valeur de retour

Retourne S _ OK en cas de réussite.

Notes

Un exemple d’utilisation de cette méthode serait de déclarer le canal comme un contrôle à distance persistant en définissant l' option de canal indicateur _ _ _ _ permanent de contrôle à distance . Cela signifie que le canal n’est pas fermé lorsqu’un contrôle à distance se connecte à ou se déconnecte de la session connectée au client. Pour plus d’informations, consultez contrôle à distance des canaux virtuels persistants.

Pour plus d’informations sur la Connexion Bureau à distance par le Web, consultez Requirements for connexion Bureau à distance par le Web.

Spécifications

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 en tant que 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Voir aussi

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

définition de canal _

CreateVirtualChannels

GetVirtualChannelOptions