IRDPSRAPIVirtualChannelManager::CreateVirtualChannel メソッド (rdpencomapi.h)
仮想チャネルを作成します。
構文
HRESULT CreateVirtualChannel(
[in] BSTR bstrChannelName,
[in] CHANNEL_PRIORITY Priority,
[in] unsigned long ChannelFlags,
[out] IRDPSRAPIVirtualChannel **ppChannel
);
パラメーター
[in] bstrChannelName
種類: BSTR
チャネルの名前。 最大長は、null 終端文字を含めて 8 文字です。 従来のチャネル名は 32 文字に制限されています。
[in] Priority
種類: CHANNEL_PRIORITY
チャネルの優先度。 このパラメーターには、次の値のいずれかを指定できます。
CHANNEL_PRIORITY_LO
CHANNEL_PRIORITY_MED
CHANNEL_PRIORITY_HI
[in] ChannelFlags
型: unsigned 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 |