Compartilhar via


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]

Identificador da 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 do estado da sessão foi enviada. Esse parâmetro pode usar um dos valores a seguir.

WTS_CONSOLE_CONNECT (0x1)

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

WTS_CONSOLE_DISCONNECT (0x2)

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

WTS_REMOTE_CONNECT (0x3)

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

WTS_REMOTE_DISCONNECT (0x4)

A sessão identificada por 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 fez logoff da sessão identificada pelo lParam.

WTS_SESSION_LOCK (0x7)

A sessão identificada por lParam foi bloqueada.

WTS_SESSION_UNLOCK (0x8)

A sessão identificada por lParam foi desbloqueada.

WTS_SESSION_REMOTE_CONTROL (0x9)

A sessão identificada por lParam alterou sua status controlada remotamente. Para determinar o status, chame GetSystemMetrics e marcar a métrica SM_REMOTECONTROL.

WTS_SESSION_CREATE (0xA)

Reservado para uso futuro.

WTS_SESSION_TERMINATE (0xB)

Reservado para uso futuro.

lParam [in]

O identificador da sessão.

Retornar valor

O valor retornado é ignorado.

Comentários

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.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

WTSRegisterSessionNotification

WTSUnRegisterSessionNotification