Функция обратного вызова PFNGENERATEGROUPPOLICY (userenv.h)

Статья
03/03/2024

Функция обратного вызова GenerateGroupPolicy — это определяемая приложением функция обратного вызова, которую каждое расширение политики должно экспортировать при создании данных RSoP в режиме планирования. Служба доступа к данным групповая политика (GPDAS) вызывает функцию после того, как служба имитирует загрузку расширений на стороне клиента, чтобы расширения могли создавать данные политики.

Тип PFNGENERATEGROUPPOLICY определяет указатель на эту функцию обратного вызова. GenerateGroupPolicy — это заполнитель для имени определяемой приложением функции.

Синтаксис

PFNGENERATEGROUPPOLICY Pfngenerategrouppolicy;

DWORD Pfngenerategrouppolicy(
  [in] DWORD dwFlags,
  [in] BOOL *pbAbort,
  [in] WCHAR *pwszSite,
  [in] PRSOP_TARGET pComputerTarget,
  [in] PRSOP_TARGET pUserTarget
)
{...}

Параметры

[in] dwFlags

Параметр , представляющий один или несколько следующих флагов.

GPO_INFO_FLAG_SLOWLINK

Политика применяется через медленный канал.

GPO_INFO_FLAG_VERBOSE

Запишите подробные выходные данные в журнал событий.

[in] pbAbort

Значение типа , указывающее, следует ли продолжать обработку объектов групповой политики. Если этот параметр имеет значение TRUE, обработка объекта групповой политики останавливается, и расширение должно освободить свои ресурсы и быстро вернуться. Если этот параметр имеет значение FALSE, обработка объекта групповой политики продолжается.

[in] pwszSite

Указатель на имя сайта целевого компьютера. Этот параметр может принимать значение NULL.

[in] pComputerTarget

Указатель на структуру RSOP_TARGET , содержащую сведения о компьютере. Этот параметр может иметь значение NULL, но если он имеет значение NULL, то параметр pUserTarget является обязательным.

[in] pUserTarget

Указатель на структуру RSOP_TARGET , содержащую сведения о пользователе. Этот параметр может иметь значение NULL, но если он имеет значение NULL, то параметр pComputerTarget является обязательным.

Возвращаемое значение

Если функция завершается успешно, возвращаемое значение будет ERROR_SUCCESS. В противном случае функция возвращает один из кодов системных ошибок. Полный список кодов ошибок см. в разделе Системные коды ошибок или в файле заголовка WinError.h.

Расширение политики должно зарегистрировать эту функцию обратного вызова в разделе реестра:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\GPExtensions\ClientExtensionGuid

REG_SZ GenerateGroupPolicy

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	userenv.h

См. также раздел

Функции групповая политика

Обзор групповых политик

RSOP_TARGET

Поделиться через