WM_WTSSESSION_CHANGE mensagem

Notifica aplicativos de alterações no estado da sessão.

A janela recebe essa mensagem por meio de sua função WindowProc .

LRESULT CALLBACK WindowProc(
  HWND hWnd,       // handle to window
  UINT Msg,        // WM_WTSSESSION_CHANGE
  WPARAM wParam,   // session state change event
  LPARAM lParam    // session ID
);

Parâmetros

hWnd [in]

Manipule para a janela.

Msg [in]

Especifica a mensagem (WM_WTSSESSION_CHANGE).

wParam [in]

Código de status que descreve o motivo pelo qual a notificação de alteração de estado da sessão foi enviada. Esse parâmetro pode ser um dos valores a seguir.

WTS_CONSOLE_CONNECT (0x1)

A sessão identificada pelo lParam foi conectada ao terminal do console ou à sessão RemoteFX.

WTS_CONSOLE_DISCONNECT (0x2)

A sessão identificada pelo lParam foi desconectada do terminal do console ou da sessão RemoteFX.

WTS_REMOTE_CONNECT (0x3)

A sessão identificada pelo lParam foi conectada ao terminal remoto.

WTS_REMOTE_DISCONNECT (0x4)

A sessão identificada pelo lParam foi desconectada do terminal remoto.

WTS_SESSION_LOGON (0x5)

Um usuário fez logon na sessão identificada pelo lParam.

WTS_SESSION_LOGOFF (0x6)

Um usuário cancelou a sessão identificada pelo lParam.

WTS_SESSION_LOCK (0x7)

A sessão identificada pelo lParam foi bloqueada.

WTS_SESSION_UNLOCK (0x8)

A sessão identificada pelo lParam foi desbloqueada.

WTS_SESSION_REMOTE_CONTROL (0x9)

A sessão identificada pelo lParam alterou seu status de controle remoto. Para determinar o status, chame GetSystemMetrics e verifique a métrica de SM_REMOTECONTROL .

WTS_SESSION_CREATE (0xA)

Reservado para uso futuro.

WTS_SESSION_TERMINATE (0xB)

Reservado para uso futuro.

WTS_SESSION_DESKTOP_READY (0xF)

A sessão identificada pelo lParam mudou para a área de trabalho do usuário.

Valor de retorno

O valor retornado é ignorado.

Observações

Essa mensagem é enviada somente para aplicativos que se registraram para receber essa mensagem chamando WTSRegisterSessionNotification.

Exemplos de como os aplicativos podem responder a essa mensagem incluem liberar ou adquirir recursos específicos do console, determinar como uma tela deve ser pintada ou disparar efeitos de animação do console.

Requirements

Consulte também

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification