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)

将来の使用のために予約済み。

WTS_SESSION_DESKTOP_READY (0xF)

lParam によって識別されるセッションが、ユーザーのデスクトップに切り替わりました。

戻り値

戻り値は無視されます。

注釈

このメッセージは、 WTSRegisterSessionNotification を呼び出してこのメッセージを受信するために登録されているアプリケーションにのみ送信されます。

アプリケーションがこのメッセージに応答する方法の例としては、コンソール固有のリソースの解放または取得、画面の描画方法の決定、コンソール アニメーション効果のトリガーなどがあります。

Requirements

こちらも参照ください

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification