Função RegisterGPNotification (userenv.h)
A função RegisterGPNotification permite que um aplicativo receba uma notificação quando houver uma alteração na política. Quando ocorre uma alteração de política, o objeto de evento especificado é definido como o estado sinalizado.
Sintaxe
USERENVAPI BOOL RegisterGPNotification(
[in] HANDLE hEvent,
[in] BOOL bMachine
);
Parâmetros
[in] hEvent
Manipule para um objeto de evento. Use a função CreateEvent para criar o objeto de evento.
[in] bMachine
Especifica o tipo de alteração de política. Se TRUE, as alterações na política do computador serão relatadas. Se FALSE, as alterações na política de usuário serão relatadas.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Chame a função UnregisterGPNotification para cancelar o registro do identificador do recebimento de notificações de alteração de política. Chame a função CloseHandle para fechar o identificador quando ele não for mais necessário.
Um aplicativo também pode receber notificações sobre alterações de política quando uma mensagem WM_SETTINGCHANGE é transmitida. Nesse caso, o valor do parâmetro wParam será 1 se a política do computador tiver sido aplicada; será zero se a política de usuário tiver sido aplicada. O parâmetro lParam aponta para a cadeia de caracteres "Policy".
Requisitos
Cliente mínimo com suporte | Windows Vista |
Servidor mínimo com suporte | Windows Server 2008 |
Plataforma de Destino | Windows |
Cabeçalho | userenv.h |
Biblioteca | Userenv.lib |
DLL | Userenv.dll |