WTSVirtualChannelOpen

指定仮想チャネルのサーバー側ハンドルを開く。

WTSVirtualChannelOpen hServer, SessionId, pVirtualName

hServer : [intptr] このパラメータは WTS_CURRENT_SERVER_HANDLE でなければならない。
SessionId : [int] リモートデスクトップサービスセッション識別子。現在のセッションを示すには WTS_CURRENT_SESSION を指定する。他ユーザのセッションで仮想チャネルを開くには Virtual Channel からの許可が必要である。
pVirtualName : [str] 仮想チャネル名を含む NULL 終端文字列へのポインタ。UNICODE 定義時も ANSI 文字列である。名前は終端 NULL を除き 1 ～ CHANNEL_NAME_LEN 文字。

(プラグイン / モジュール : wtsapi32.dll)

解説

指定仮想チャネルのサーバー側ハンドルを開く。

[戻り値]
関数が成功すると戻り値は指定仮想チャネルへのハンドルとなる。関数が失敗した場合、戻り値は NULL となる。拡張エラー情報を取得するには
GetLastError を呼び出す。

[備考]
ハンドル使用後は WTSVirtualChannelClose で解放する。非同期 I/O 用の仮想チャネルファイルハンドル取得例は
WTSVirtualChannelQuery を参照。同じ仮想チャネルを複数回開こうとすると 10
秒の遅延と既存チャネルの破壊を招くことがある。

情報