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

Confira também

Funções Política de Grupo

Visão geral da Política de Grupo

UnregisterGPNotification