IMsRdpClient::SetVirtualChannelOptions-Methode
Legt die Optionen des virtuellen Kanals für das ActiveX-Remotedesktop-Steuerelement fest.
Rufen Sie diese Methode nach dem Aufrufen der CreateVirtualChannels-Methode , aber vor dem Herstellen einer Verbindung mit der Connect-Methode auf. Diese Methode legt zusätzliche Optionen für virtuelle Kanäle fest, die mit CreateVirtualChannels erstellt wurden.
Syntax
HRESULT SetVirtualChannelOptions(
[in] BSTR ChanName,
[in] LONG chanOptions
);
Parameter
-
ChanName [in]
-
Der Name des virtuellen Kanals, der im Aufruf der CreateVirtualChannels-Methode angegeben wurde.
-
chanOptions [in]
-
Die Optionen, die für den durch den ChanName-Parameter angegebenen virtuellen Kanal festgelegt werden sollen. Eine Beschreibung der möglichen Optionen finden Sie unter CHANNEL_DEF. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Rückgabewert
Gibt bei erfolgreicher Ausführung S_OK zurück.
Hinweise
Ein Beispiel für die Verwendung dieser Methode wäre das Deklarieren des Kanals als persistente Remotesteuerung durch Festlegen des CHANNEL_OPTION_REMOTE_CONTROL_PERSISTENT Flags. Dies bedeutet, dass der Kanal nicht geschlossen wird, wenn eine Remotesteuerung eine Verbindung mit der Sitzung herstellt oder die Verbindung mit dem Client trennt. Weitere Informationen finden Sie unter Remotesteuerung persistenter virtueller Kanäle.
Weitere Informationen zur Remotedesktop-Webverbindung finden Sie unter Anforderungen für die Remotedesktopwebverbindung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Typbibliothek |
|
| DLL |
|
| IID |
IID_IMsRdpClient ist definiert als 92b4a539-7115-4b7c-a5a9-e5d9efc2780a |