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 |