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

Confira também

Funções Política de Grupo

Visão geral da Política de Grupo

UnregisterGPNotification