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

こちらもご覧ください

WTSOpenServer