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

Confira também

HandlerEx

WM_WTSSESSION_CHANGE

WTSGetActiveConsoleSessionId

WTSOpenServer

WTSSESSION_NOTIFICATION

WTSUnRegisterSessionNotificationEx