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