IRDPSRAPIVirtualChannelManager::CreateVirtualChannel-Methode (rdpencomapi.h)

Erstellt einen virtuellen Kanal.

Syntax

HRESULT CreateVirtualChannel(
  [in]  BSTR                    bstrChannelName,
  [in]  CHANNEL_PRIORITY        Priority,
  [in]  unsigned long           ChannelFlags,
  [out] IRDPSRAPIVirtualChannel **ppChannel
);

Parameter

[in] bstrChannelName

Typ: BSTR

Der Name des Channels. Die maximale Länge beträgt 8 Zeichen, einschließlich des NULL-Endzeichens. Legacykanalnamen sind auf 32 Zeichen beschränkt.

[in] Priority

Typ: CHANNEL_PRIORITY

Die Priorität des Kanals. Dieser Parameter kann einen der folgenden Werte annehmen.

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

Typ: unsigned long

Flags, die bestimmen, wie Daten auf dem Kanal gesendet werden. Dieser Parameter kann 0 oder CHANNEL_FLAGS_UNCOMPRESSED sein.

[out] ppChannel

Typ: IRDPSRAPIVirtualChannel**

Ein IRDPSRAPIVirtualChannel-Schnittstellenzeiger .

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls ist der Rückgabewert ein Fehlercode. Im Folgenden ist ein möglicher Wert aufgeführt.

Hinweise

Wenn ein virtueller Kanal erstellt wird, wird für jeden geöffneten Kanal ein virtueller RDP-Kanal an die RDP-Stapelebene gebunden. Damit ein Kanal tatsächlich zwischen dem Client und dem Server geöffnet werden kann, müssen sowohl der Client als auch der Server den Kanal binden. Der Priority-Parameter wird verwendet, um den Paketen, die auf dem Kanal gesendet werden, eine Priorität zuzuweisen.

Die Bindung zwischen Server- und Clientkanälen wird basierend auf dem Kanalnamen eingerichtet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	rdpencomapi.h
DLL	RdpEncom.dll

Weitere Informationen

IRDPSRAPIVirtualChannelManager