Função WTSWaitSystemEvent (wtsapi32.h)
Aguarda um evento dos Serviços de Área de Trabalho Remota antes de retornar ao chamador.
Sintaxe
BOOL WTSWaitSystemEvent(
[in] HANDLE hServer,
[in] DWORD EventMask,
[out] DWORD *pEventFlags
);
Parâmetros
[in] hServer
Manipule para um servidor host de sessão de área de trabalho remota. Especifique um identificador aberto pela função WTSOpenServer ou especifique WTS_CURRENT_SERVER_HANDLE para indicar o servidor Host da Sessão de Área de Trabalho Remota no qual o aplicativo está sendo executado.
[in] EventMask
Bitmask que especifica o conjunto de eventos a aguardar. Essa máscara pode ser WTS_EVENT_FLUSH para fazer com que todas as chamadas WTSWaitSystemEvent pendentes no identificador do servidor host da sessão rd especificado retornem. Ou a máscara pode ser uma combinação dos valores a seguir.
WTS_EVENT_ALL
Aguarde qualquer tipo de evento.
WTS_EVENT_CONNECT
Um cliente conectado a um WinStation.
WTS_EVENT_CREATE
Um novo WinStation foi criado.
WTS_EVENT_DELETE
Um WinStation existente foi excluído.
WTS_EVENT_DISCONNECT
Um cliente desconectado de um WinStation.
WTS_EVENT_LICENSE
O estado de licença dos Serviços de Área de Trabalho Remota foi alterado. Isso ocorre quando uma licença é adicionada ou excluída usando o Gerenciador de Licenças.
WTS_EVENT_LOGOFF
Um usuário fez logon no console dos Serviços de Área de Trabalho Remota ou em um WinStation cliente.
WTS_EVENT_LOGON
Um usuário fez logon no sistema no console dos Serviços de Área de Trabalho Remota ou em um WinStation cliente.
WTS_EVENT_RENAME
Um WinStation existente foi renomeado.
WTS_EVENT_STATECHANGE
Um estado de conexão do WinStation foi alterado. Para obter uma lista de estados de conexão, consulte o tipo de enumeração WTS_CONNECTSTATE_CLASS.
[out] pEventFlags
Ponteiro para uma variável que recebe uma máscara de bits do evento ou eventos que ocorreram. A máscara retornada pode ser uma combinação dos valores da lista anterior ou pode ser WTS_EVENT_NONE se a espera for encerrada devido a uma chamada WTSWaitSystemEvent com WTS_EVENT_FLUSH.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
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 |