Freigeben über


IWRdsProtocolConnection::CreateVirtualChannel-Methode (wtsprotocol.h)

Fordert an, dass das Protokoll einen virtuellen Kanal erstellt.

Syntax

HRESULT CreateVirtualChannel(
  [in]  CHAR      *szEndpointName,
  [in]  BOOL      bStatic,
  [in]  ULONG     RequestedPriority,
  [out] ULONG_PTR *phChannel
);

Parameter

[in] szEndpointName

Eine NULL-endende Zeichenfolge, die die Endpunktdaten enthält, die die Verbindung eindeutig identifizieren.

[in] bStatic

Gibt an, ob der virtuelle Kanal statisch oder dynamisch ist.

true

Der Kanal ist statisch.

false

Der Kanal ist dynamisch.

[in] RequestedPriority

Gibt die angeforderte Priorität für den Kanal an.

[out] phChannel

Ein Zeiger auf einen ULONG-Wert , der das Handle für den erstellten Kanal empfängt.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Virtuelle Kanäle sind Softwareerweiterungen, die erstellt werden können, um eine Remotedesktopdienstanwendung zu verbessern. Beispiele hierfür sind die Unterstützung für zusätzliche Hardware oder Ergänzungen der Funktionen, die von einem bestimmten Protokoll bereitgestellt werden. Weitere Informationen finden Sie unter Virtuelle Kanäle für Remotedesktopdienste.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile wtsprotocol.h

Weitere Informationen

IWRdsProtocolConnection