IRDPSRAPIVirtualChannelManager：：CreateVirtualChannel 方法 (rdpencomapi.h)

發行項
03/05/2024

建立虛擬通道。

語法

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

參數

[in] bstrChannelName

類型： BSTR

通道的名稱。長度上限為8個字元，包括 Null 終止字元。舊版通道名稱限製為32個字元。

[in] Priority

類型： CHANNEL_PRIORITY

通道的優先順序。此參數可以是下列其中一個值。

CHANNEL_PRIORITY_LO

CHANNEL_PRIORITY_MED

CHANNEL_PRIORITY_HI

[in] ChannelFlags

類型： 不帶正負號的long

決定通道上數據傳送方式的旗標。此參數可以是 0 或 CHANNEL_FLAGS_UNCOMPRESSED。

[out] ppChannel

類型： IRDPSRAPIVirtualChannel**

IRDPSRAPIVirtualChannel 介面指標。

傳回值

類型： HRESULT

如果方法成功，傳回值會 S_OK。否則，傳回值是錯誤碼。以下是可能的值。

備註

建立虛擬通道時，每個開啟的通道都會在 RDP 堆疊層系結 RDP 虛擬通道。若要在用戶端與伺服器之間實際開啟通道，用戶端和伺服器都必須系結通道。 Priority 參數可用來將優先順序指派給通道上傳送的封包。

伺服器和用戶端通道之間的系結是根據通道名稱所建立。

規格需求

需求	值
最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	rdpencomapi.h
Dll	RdpEncom.dll

另請參閱

IRDPSRAPIVirtualChannelManager

共用方式為