WTSEnumerateSessionsA 関数 (wtsapi32.h)
リモート デスクトップ セッション ホスト (RD セッション ホスト) サーバー上のセッションの一覧を取得します。
構文
BOOL WTSEnumerateSessionsA(
[in] HANDLE hServer,
[in] DWORD Reserved,
[in] DWORD Version,
[out] PWTS_SESSION_INFOA *ppSessionInfo,
[out] DWORD *pCount
);
パラメーター
[in] hServer
RD セッション ホスト サーバーへのハンドル。
[in] Reserved
このパラメーターは予約されています。 0 にする必要があります。
[in] Version
列挙要求のバージョン。 このパラメーターは 1 である必要があります。
[out] ppSessionInfo
取得したセッションを表す WTS_SESSION_INFO 構造体の配列へのポインター。 返されたバッファーを解放するには、WTSFreeMemory 関数を呼び出します。
セッションのアクセス許可:
- セッションを列挙するには、クエリ情報のアクセス許可を有効にする必要があります。 詳細については、「リモート デスクトップ サービスのアクセス許可
する」を参照してください。 - セッションのアクセス許可を変更するには、リモート デスクトップ サービス構成管理ツールを使用します。
- RD 仮想化ホスト サーバーでホストされている仮想マシンで実行されているセッションを列挙するには、RD 仮想化ホスト サーバーの Administrators グループのメンバーである必要があります。
[out] pCount
ppSessionInfo パラメーターで返される WTS_SESSION_INFO 構造体の数へのポインター。
戻り値
この関数が失敗した場合は 0 を返します。 この関数が成功すると、0 以外の値が返されます。
拡張エラー情報を取得するには、GetLastError
備考
手記
wtsapi32.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして WTSEnumerateSessions を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista |
| サポートされる最小サーバー | Windows Server 2008 |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wtsapi32.h |
| ライブラリ | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| API セットの | ext-ms-win-session-wtsapi32-l1-1-0 (Windows 8 で導入) |