WTSEnumerateSessionsExW

指定 RD セッションホストまたは RD 仮想化ホストサーバー上のセッション一覧を取得する。(Unicode)

WTSEnumerateSessionsExW hServer, pLevel, Filter, ppSessionInfo, pCount

hServer : [intptr] 対象サーバーへのハンドル。WTSOpenServer/WTSOpenServerEx で返されたハンドルを指定する。アプリ実行中サーバーを対象にするには WTS_CURRENT_SERVER_HANDLE を指定する。
pLevel : [var] このパラメータは予約されている。常に 1 に設定する。出力時に値は変更されない。
Filter : [int] このパラメータは予約されている。常に 0 に設定する。
ppSessionInfo : [var] WTS_SESSION_INFO_1 配列へのポインタを受け取る PWTS_SESSION_INFO_1 変数へのポインタ。各構造体は指定 RD セッションホスト上のセッション情報を含む。WTSOpenServerEx で開いた RD 仮想化ホストのハンドルなら、仮想マシン上のセッション情報となる。使用後は WTSFreeMemoryEx で解放し、ポインタを NULL に設定する。
pCount : [var] ppSessionInfo バッファに返される WTS_SESSION_INFO_1 構造体数を受け取る DWORD 変数へのポインタ。

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

解説

指定 RD セッションホストまたは RD 仮想化ホストサーバー上のセッション一覧を取得する。(Unicode)

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

[備考]
RD 仮想化ホスト上の仮想マシンセッション情報を取得するには WTSOpenServerEx
でハンドルを取得する必要がある。返されたバッファを解放するには WTSFreeMemoryEx を呼び出し WTSClassType に
WTSTypeSessionInfoLevel1 を指定する。セッションを列挙するには Query Information
権限が必要である。仮想マシンセッションを列挙するには Administrators グループのメンバである必要がある。
> [!NOTE] > wtsapi32.h は WTSEnumerateSessionsEx を ANSI/Unicode
自動選択エイリアスとして定義している。

情報