WTSVirtualChannelQuery

指定仮想チャネルに関する情報を返す。

WTSVirtualChannelQuery hChannelHandle, param1, ppBuffer, pBytesReturned

hChannelHandle : [intptr] WTSVirtualChannelOpen で開かれた仮想チャネルへのハンドル。
param1 : [int] 
ppBuffer : [var] 要求された情報を受け取るバッファへのポインタ。
pBytesReturned : [var] ppBuffer に返されたバイト数を受け取る変数へのポインタ。

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

解説

指定仮想チャネルに関する情報を返す。

[戻り値]
関数が成功すると戻り値は 0 以外となる。ppBuffer に返された値で WTSFreeMemory
を呼んで一時メモリを解放する。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
非同期 I/O に使える仮想チャネルファイルハンドルを取得する方法例: まず WTSVirtualChannelOpen
で仮想チャネルを開き、WTSVirtualChannelQuery に WTSVirtualFileHandle
を指定して呼ぶとファイルハンドルが返る。これを使って重複読み書きができる。WTSVirtualChannelQuery が確保したメモリは
WTSFreeMemory で解放し、仮想チャネルは WTSVirtualChannelClose
で閉じる。取得したファイルハンドルは明示的に閉じるべきではない (WTSVirtualChannelClose
が閉じるため)。このドキュメントは省略されている。

情報