WTSVirtualChannelOpenEx 関数 (wtsapi32.h)
WTSVirtualChannelOpen と同様の方法で仮想チャネルを作成します。
この API では、静的仮想チャネル (SVC) と動的仮想チャネル (DVC) の作成の両方がサポートされています。 flags パラメーターが 0 の場合、WTSVirtualChannelOpen と同じように動作します。 DVC は、適切なフラグを指定することで開くことができます。 DVC を作成した後、SVC に使用される読み取り、書き込み、クエリ、または Close に対して同じ関数を使用できます。
構文
HANDLE WTSVirtualChannelOpenEx(
[in] DWORD SessionId,
[in] LPSTR pVirtualName,
[in] DWORD flags
);
パラメーター
[in] SessionId
リモート デスクトップ サービスのセッション識別子。 現在のセッションを示すには、 WTS_CURRENT_SESSIONを指定します。 WTSEnumerateSessions 関数を使用して、指定された RD セッション ホスト サーバー上のすべてのセッションの識別子を取得できます。
別のユーザーのセッションで仮想チャネルを開くには、仮想チャネルのアクセス許可が必要です。 詳細については、「 リモート デスクトップ サービスのアクセス許可」を参照してください。 セッションのアクセス許可を変更するには、リモート デスクトップ サービス構成管理ツールを使用します。
[in] pVirtualName
SVC の場合、仮想チャネル名を含む null で終わる文字列を指します。 SVC 名の長さは、終端の null を含めず、 CHANNEL_NAME_LEN 文字に制限されます。
DVC の場合、リスナーのエンドポイント名を含む null で終わる文字列を指します。 DVC 名の長さは、 MAX_PATH 文字に制限されます。
[in] flags
チャネルを SVC として開くには、このパラメーターに 0 を指定します。 チャネルを DVC として開くには、WTS_CHANNEL_OPTION_DYNAMICを指定 します。
DVC を開くときに、転送されるデータの優先順位設定を指定するには、WTS_CHANNEL_OPTION_DYNAMIC値と組み合わせてWTS_CHANNEL_OPTION_DYNAMIC_PRI_XXX 値のいずれかを指定します。
WTS_CHANNEL_OPTION_DYNAMIC_NO_COMPRESS
この DVC の圧縮を無効にします。 この値は 、WTS_CHANNEL_OPTION_DYNAMIC 値と組み合わせて指定する必要があります。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_LOW (既定値)
低優先度。 データは優先順位の低い両側で送信されます。 転送速度が重要ではないすべてのサイズのブロック転送には、この優先度レベルを使用します。 ほぼすべての場合 (95%) では、チャネルをこのフラグで開く必要があります。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_MED
優先度が中程度です。 この優先度レベルを使用して、優先度の低いチャネルのデータよりも優先順位が必要な短い制御メッセージを送信します。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_HIGH
優先度が高い。 この優先度レベルは、ユーザー エクスペリエンスに直接影響を与える重要なデータに使用します。 転送サイズは異なる場合があります。 表示データは、このカテゴリに分類されます。
WTS_CHANNEL_OPTION_DYNAMIC_PRI_REAL
リアルタイム優先度。 この優先度レベルは、データ転送が絶対に重要な場合にのみ使用してください。 データ転送サイズは、メッセージあたり数百バイトに制限する必要があります。
戻り値
GetLastError が設定された場合のエラー時の NULL。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wtsapi32.h |
| Library | Wtsapi32.lib |
| [DLL] | Wtsapi32.dll |
| API セット | ext-ms-win-session-wtsapi32-l1-1-0 (Windows 8で導入) |