Compartir a través de


Función RegisterGPNotification (userenv.h)

La función RegisterGPNotification permite a una aplicación recibir notificaciones cuando hay un cambio en la directiva. Cuando se produce un cambio de directiva, el objeto de evento especificado se establece en el estado señalado.

Sintaxis

USERENVAPI BOOL RegisterGPNotification(
  [in] HANDLE hEvent,
  [in] BOOL   bMachine
);

Parámetros

[in] hEvent

Identificador de un objeto de evento. Use la función CreateEvent para crear el objeto de evento.

[in] bMachine

Especifica el tipo de cambio de directiva. Si es TRUE, se notifican los cambios en la directiva de equipo. Si es FALSE, se notifican cambios en la directiva de usuario.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Llame a la función UnregisterGPNotification para anular el registro del identificador de recibir notificaciones de cambio de directiva. Llame a la función CloseHandle para cerrar el identificador cuando ya no sea necesario.

Una aplicación también puede recibir notificaciones sobre los cambios de directiva cuando se difunde un mensaje de WM_SETTINGCHANGE . En este caso, el valor del parámetro wParam es 1 si se aplicó la directiva de equipo; es cero si se aplicó la directiva de usuario. El parámetro lParam apunta a la cadena "Policy".

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado userenv.h
Library Userenv.lib
Archivo DLL Userenv.dll

Consulte también

Funciones de directiva de grupo

Introducción a las directivas de grupo

Anular el registroGPNotification