Функция RegisterGPNotification (userenv.h)
Функция RegisterGPNotification позволяет приложению получать уведомления при изменении политики. При изменении политики указанный объект события устанавливается в состояние сигнала.
Синтаксис
USERENVAPI BOOL RegisterGPNotification(
[in] HANDLE hEvent,
[in] BOOL bMachine
);
Параметры
[in] hEvent
Дескриптор объекта события. Используйте функцию CreateEvent для создания объекта события.
[in] bMachine
Указывает тип изменения политики. Если значение РАВНО TRUE, отображаются изменения политики компьютера. При значении FALSE сообщается об изменениях политики пользователя.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Вызовите функцию UnregisterGPNotification , чтобы отменить регистрацию дескриптора от получения уведомлений об изменениях политики. Вызовите функцию CloseHandle , чтобы закрыть дескриптор, когда он больше не требуется.
Приложение также может получать уведомления об изменениях политики при широковещательном WM_SETTINGCHANGE сообщении. В этом случае значение параметра wParam равно 1, если политика компьютера была применена; Значение равно нулю, если политика пользователя была применена. Параметр lParam указывает на строку Policy.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | userenv.h |
| Библиотека | Userenv.lib |
| DLL | Userenv.dll |