IMsRdpClient::SetVirtualChannelOptions-Methode

  • Artikel

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
MsTscAx.dll
DLL
MsTscAx.dll
IID
 IID_IMsRdpClient ist definiert als 92b4a539-7115-4b7c-a5a9-e5d9efc2780a

Weitere Informationen

IMsRdpClient

IMsRdpClient2

IMsRdpClient3

IMsRdpClient4

IMsRdpClient5

IMsRdpClient6

IMsRdpClient7

IMsRdpClient8

IMsRdpClient9

IMsRdpClient10

CHANNEL_DEF

CreateVirtualChannels

GetVirtualChannelOptions