Função WTSRegisterSessionNotification (wtsapi32.h)

Artigo
03/09/2024

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)