Função WTSRegisterSessionNotificationEx (wtsapi32.h)
Registra a janela especificada para receber notificações de alteração de sessão.
Sintaxe
BOOL WTSRegisterSessionNotificationEx(
[in] HANDLE hServer,
[in] HWND hWnd,
[in] DWORD dwFlags
);
Parâmetros
[in] hServer
Identificador do servidor retornado de WTSOpenServer ou WTS_CURRENT_SERVER.
[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 só poderá ser NOTIFY_FOR_THIS_SESSION se hServer for um servidor remoto.
NOTIFY_FOR_THIS_SESSION (0)
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 (1)
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 WM_WTSSESSION_CHANGE . Essas notificações são enviadas apenas para as janelas que se registraram para elas usando essa função.
Quando uma janela não exige mais essas notificações, ela deve chamar WTSUnRegisterSessionNotificationEx antes de ser destruída. Para cada chamada para essa função, deve haver uma chamada correspondente para WTSUnRegisterSessionNotificationEx.
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 |