Função WTSRegisterSessionNotification (wtsapi32.h)
Registra a janela especificada para receber notificações de alteração de sessão.
Sintaxe
BOOL WTSRegisterSessionNotification(
[in] HWND hWnd,
[in] DWORD dwFlags
);
Parâmetros
[in] hWnd
Identificador da janela para receber notificações de alteração de sessão.
[in] dwFlags
Especifica quais notificações de sessão devem ser recebidas. Esse parâmetro pode usar um dos valores a seguir.
NOTIFY_FOR_THIS_SESSION
Somente as notificações de sessão que envolvem a sessão anexada pela janela identificada pelo valor do parâmetro hWnd devem ser recebidas.
NOTIFY_FOR_ALL_SESSIONS
Todas as notificações de sessão devem ser recebidas.
Retornar valor
Se a função for bem-sucedida, o valor retornado será TRUE. Caso contrário, será FALSE. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Se essa função for chamada antes que os serviços dependentes dos Serviços de Área de Trabalho Remota tenham sido iniciados, um código de erro RPC_S_INVALID_BINDING poderá ser retornado. Quando o evento global Global\TermSrvReadyEvent é definido, todos os serviços dependentes são iniciados e essa função pode ser chamada com êxito.
As notificações de alteração de sessão são enviadas na forma de uma mensagem de WM_WTSSESSION_CHANGE . Essas notificações são enviadas somente para as janelas que se registraram para elas usando essa função.
Quando uma janela não requer mais essas notificações, ela deve chamar WTSUnRegisterSessionNotification antes de ser destruída. Para cada chamada a essa função, deve haver uma chamada correspondente para WTSUnRegisterSessionNotification.
Se o identificador de janela passado nessa função já estiver registrado, o valor do parâmetro dwFlags será ignorado.
Para receber notificações de alteração de sessão de um serviço, use a função HandlerEx .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | wtsapi32.h |
| Biblioteca | Wtsapi32.lib |
| DLL | Wtsapi32.dll |
| Conjunto de APIs | ext-ms-win-session-wtsapi32-l1-1-0 (introduzido no Windows 8) |