メッセージのWM_WTSSESSION_CHANGE
セッション状態の変更をアプリケーションに通知します。
ウィンドウは、 WindowProc 関数を介してこのメッセージを受け取ります。
LRESULT CALLBACK WindowProc(
HWND hWnd, // handle to window
UINT Msg, // WM_WTSSESSION_CHANGE
WPARAM wParam, // session state change event
LPARAM lParam // session ID
);
パラメーター
-
hWnd [in]
-
ウィンドウへのハンドル。
-
Msg [in]
-
メッセージ (WM_WTSSESSION_CHANGE) を指定します。
-
wParam [in]
-
セッション状態変更通知が送信された理由を示す状態コード。 このパラメーターには、次の値のいずれかを指定できます。
-
WTS_CONSOLE_CONNECT (0x1)
-
lParam によって識別されたセッションは、コンソールターミナルまたはRemoteFXセッションに接続されました。
-
WTS_CONSOLE_DISCONNECT (0x2)
-
lParam によって識別されたセッションがコンソールターミナルまたはRemoteFXセッションから切断されました。
-
WTS_REMOTE_CONNECT (0x3)
-
lParam によって識別されたセッションがリモートターミナルに接続されました。
-
WTS_REMOTE_DISCONNECT (0x4)
-
lParam によって識別されたセッションがリモートターミナルから切断されました。
-
WTS_SESSION_LOGON (0x5)
-
ユーザーは 、lParam によって識別されるセッションにログオンしています。
-
WTS_SESSION_LOGOFF (0x6)
-
ユーザーが lParam によって識別されたセッションをログオフしました。
-
WTS_SESSION_LOCK (0x7)
-
lParam によって識別されるセッションがロックされています。
-
WTS_SESSION_UNLOCK (0x8)
-
lParam によって識別されるセッションのロックが解除されました。
-
WTS_SESSION_REMOTE_CONTROL (0x9)
-
lParam によって識別されるセッションは、そのリモート制御状態を変更しました。 状態を確認するには、 GetSystemMetrics を 呼び出し、 SM_REMOTECONTROL メトリックを確認します。
-
WTS_SESSION_CREATE (0xA)
-
将来利用するために予約されています。
-
WTS_SESSION_TERMINATE (0xB)
-
将来利用するために予約されています。
lParam [in]
セッションの識別子。
戻り値
戻り値は無視されます。
解説
このメッセージは、 WTSRegisterSessionNotification を呼び出してこのメッセージを受信するために登録されているアプリケーションにのみ送信されます。
アプリケーションがこのメッセージに応答する方法の例としては、コンソール固有のリソースの解放または取得、画面の描画方法の決定、コンソール アニメーション効果のトリガーなどがあります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| ヘッダー |
|