WTSVirtualChannelOpen 関数 (wtsapi32.h)

指定した仮想チャネルのサーバー側へのハンドルを開きます。

この関数は、現在使用されていません。 代わりに、 WTSVirtualChannelOpenEx 関数を 使用します。

構文

HANDLE WTSVirtualChannelOpen(
  [in] HANDLE hServer,
  [in] DWORD  SessionId,
  [in] LPSTR  pVirtualName
);

パラメーター

[in] hServer

このパラメーターはWTS_CURRENT_SERVER_HANDLEする必要があります。

[in] SessionId

リモート デスクトップ サービスのセッション識別子。 現在のセッションを示すには、 WTS_CURRENT_SESSIONを指定します。 WTSEnumerateSessions 関数を使用して、指定された RD セッション ホスト サーバー上のすべてのセッションの識別子を取得できます。

別のユーザーのセッションで仮想チャネルを開くには、仮想チャネルからのアクセス許可が必要です。 詳細については、「 リモート デスクトップ サービスのアクセス許可」を参照してください。 セッションのアクセス許可を変更するには、リモート デスクトップ サービス構成管理ツールを使用します。

[in] pVirtualName

仮想チャネル名を含む null で終わる文字列へのポインター。 UNICODE が定義されている場合でも、これは ANSI 文字列であることに注意してください。 仮想チャネル名は、終端の null を含まない 1 からCHANNEL_NAME_LEN文字で構成されます。

戻り値

関数が成功した場合、戻り値は指定された仮想チャネルへのハンドルです。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

ハンドルの使用が完了したら、 WTSVirtualChannelClose 関数を呼び出して解放します。

非同期 I/O に使用できる仮想チャネル ファイル ハンドルにアクセスする方法を示す例については、「 WTSVirtualChannelQuery」を参照してください。

この関数を使用して同じ仮想チャネルを複数回開こうとすると、10 秒の遅延が発生し、確立されたチャネルが中断される可能性があります。

要件

こちらもご覧ください

WTSEnumerateSessions

WTSOpenServer

WTSVirtualChannelClose