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。

要件

こちらもご覧ください

DVC サーバー API

動的仮想チャネル リファレンス

WTSVirtualChannelOpen