WTSWaitSystemEvent 関数 (wtsapi32.h)
呼び出し元に戻る前に、リモート デスクトップ サービス イベントを待機します。
構文
BOOL WTSWaitSystemEvent(
[in] HANDLE hServer,
[in] DWORD EventMask,
[out] DWORD *pEventFlags
);
パラメーター
[in] hServer
RD セッション ホスト サーバーへの処理。 WTSOpenServer 関数によって開かれたハンドルを指定するか、WTS_CURRENT_SERVER_HANDLEを指定して、アプリケーションが実行されている RD セッション ホスト サーバーを示します。
[in] EventMask
待機するイベントのセットを指定するビットマスク。 このマスクをWTS_EVENT_FLUSHすると、指定した RD セッション ホスト サーバー ハンドルで保留中のすべての WTSWaitSystemEvent 呼び出しが返されます。 または、マスクは、以下の値の組み合わせとすることができる。
WTS_EVENT_ALL
任意のイベントの種類を待ちます。
WTS_EVENT_CONNECT
WinStation に接続されているクライアント。
WTS_EVENT_CREATE
新しい WinStation が作成されました。
WTS_EVENT_DELETE
既存の WinStation が削除されました。
WTS_EVENT_DISCONNECT
WinStation から切断されたクライアント。
WTS_EVENT_LICENSE
リモート デスクトップ サービスのライセンス状態が変更されました。 これは、ライセンス マネージャーを使用してライセンスが追加または削除されたときに発生します。
WTS_EVENT_LOGOFF
ユーザーがリモート デスクトップ サービス コンソールまたはクライアント WinStation からログオフしました。
WTS_EVENT_LOGON
リモート デスクトップ サービス コンソールまたはクライアント WinStation からシステムにログオンしたユーザー。
WTS_EVENT_RENAME
既存の WinStation の名前が変更されました。
WTS_EVENT_STATECHANGE
WinStation 接続の状態が変更されました。 接続状態の一覧については、「 WTS_CONNECTSTATE_CLASS 列挙型」を参照してください。
[out] pEventFlags
発生したイベントまたはイベントのビットマスクを受け取る変数へのポインター。 返されるマスクは、前のリストの値の組み合わせである場合があります。また、wtsWaitSystemEvent 呼び出しが原因で待機が終了した場合は、WTS_EVENT_FLUSH WTS_EVENT_NONEできます。
戻り値
関数が成功した場合、戻り値は 0 以外の値になります。
関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wtsapi32.h |
| Library | Wtsapi32.lib |
| [DLL] | Wtsapi32.dll |