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 秒の遅延が発生し、確立されたチャネルが中断される可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | 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で導入) |