Функция GetAppliedGPOListA (userenv.h)

Статья
11/20/2024

Функция GetAppliedGPOList извлекает список объектов групповой политики, примененных для указанного пользователя или компьютера.

Синтаксис

USERENVAPI DWORD GetAppliedGPOListA(
  [in]  DWORD                 dwFlags,
  [in]  LPCSTR                pMachineName,
  [in]  PSID                  pSidUser,
  [in]  GUID                  *pGuidExtension,
  [out] PGROUP_POLICY_OBJECTA *ppGPOList
);

Параметры

[in] dwFlags

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

GPO_LIST_FLAG_MACHINE

Извлекает сведения о политике компьютера.

Если это значение не указано, функция извлекает только сведения о политике пользователя.

[in] pMachineName

Указатель на имя удаленного компьютера. Формат имени — "\\computer_name". Если этот параметр значение NULL, используется имя локального компьютера.

[in] pSidUser

Значение, указывающее идентификатор безопасности пользователя. Если pMachineName не NULL и dwFlags указывает политику пользователя, pSidUser нельзя NULL.

Если pMachineNameNULL и pSidUserNULL, пользователь является пользователем, вошедшего в систему. Если pMachineNameNULL и pSidUser не NULL, пользователь представлен pSidUser на локальном компьютере. Дополнительные сведения см. в разделе Идентификаторы безопасности.

[in] pGuidExtension

Значение, указывающее GUID расширения.

[out] ppGPOList

Указатель, который получает список структур групповой политики. Дополнительные сведения см. в GROUP_POLICY_OBJECT.

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

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

Замечания

Чтобы освободить список групповой политики после завершения обработки, вызовите функцию FreeGPOList.

Заметка

Заголовок userenv.h определяет GetAppliedGPOList как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	userenv.h
библиотеки	Userenv.lib
DLL	Userenv.dll