WTSQuerySessionInformationW

指定 RD セッションホストサーバー上の指定セッションのセッション情報を取得する。(Unicode)

WTSQuerySessionInformationW hServer, SessionId, WTSInfoClass, ppBuffer, pBytesReturned

hServer : [intptr] RD セッションホストサーバーへのハンドル。WTSOpenServer で開いたハンドル、または WTS_CURRENT_SERVER_HANDLE を指定する。
SessionId : [int] リモートデスクトップサービスセッション識別子。呼び出し元アプリが動作中のセッション (現在のセッション) を示すには WTS_CURRENT_SESSION を指定する。ローカルサーバー上で情報取得する場合のみ WTS_CURRENT_SESSION を指定すること。リモートサーバーで指定すると返される情報は信頼できない。他ユーザのセッション情報を問い合わせるには Query Information 権限が必要である。
WTSInfoClass : [int] 取得するセッション情報の種類を示す WTS_INFO_CLASS 列挙の値。
ppBuffer : [var] 要求された情報へのポインタを受け取る変数へのポインタ。データの形式・内容は WTSInfoClass に依存する。使用後は WTSFreeMemory で解放する。
pBytesReturned : [var] ppBuffer に返されるデータのバイトサイズを受け取る変数へのポインタ。

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

解説

指定 RD セッションホストサーバー上の指定セッションのセッション情報を取得する。(Unicode)

[戻り値]
関数が成功すると戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
リモートデスクトップサービス実行中に現在のセッション ID を取得するには、SessionId を
WTS_CURRENT_SESSION、WTSInfoClass を WTSSessionId にして呼び出す。セッション ID は
ppBuffer で返される。リモートデスクトップサービスが動作していないと呼び出しは失敗する。その場合は
ProcessIdToSessionId で取得できる。アプリが物理コンソール上で動作中か判定するには
WTS_CURRENT_SESSION と WTSClientProtocolType を指定する。ppBuffer が "0"
なら物理コンソールにアタッチされている。
> [!NOTE] > wtsapi32.h は WTSQuerySessionInformation を ANSI/Unicode
自動選択エイリアスとして定義している。

情報