структура GROUP_POLICY_OBJECTA (userenv.h)
Структура GROUP_POLICY_OBJECT предоставляет сведения о объекте групповой политики в списке объектов групповой политики.
Синтаксис
typedef struct _GROUP_POLICY_OBJECTA {
DWORD dwOptions;
DWORD dwVersion;
LPSTR lpDSPath;
LPSTR lpFileSysPath;
LPSTR lpDisplayName;
CHAR szGPOName[50];
GPO_LINK GPOLink;
LPARAM lParam;
struct _GROUP_POLICY_OBJECTA *pNext;
struct _GROUP_POLICY_OBJECTA *pPrev;
LPSTR lpExtensions;
LPARAM lParam2;
LPSTR lpLink;
} GROUP_POLICY_OBJECTA, *PGROUP_POLICY_OBJECTA;
Члены
dwOptions
Задает параметры ссылки. Этот элемент может быть одним из следующих значений.
GPO_FLAG_DISABLE
Этот объект групповой политики отключен.
GPO_FLAG_FORCE
Не переопределяете параметры политики в этом объекте групповой политики с параметрами политики в последующем объекте групповой политики.
dwVersion
Указывает номер версии объекта групповой политики.
lpDSPath
Указатель на строку, указывающую путь к части службы каталогов объекта групповой политики.
lpFileSysPath
Указатель на строку, указывающую путь к части файловой системы объекта групповой политики.
lpDisplayName
Указатель на отображаемое имя объекта групповой политики.
szGPOName[50]
Указатель на строку, указывающую уникальное имя, определяющее объект групповой политики.
GPOLink
Указывает сведения о ссылке для объекта групповой политики. Этот элемент может быть одним из следующих значений.
GPLinkUnknown
Нет сведений о ссылке.
GPLinkMachine
Объект групповой политики связан с компьютером (локальным или удаленным).
GPLinkSite
Объект групповой политики связан с сайтом.
GPLinkDomain
Объект групповой политики связан с доменом.
GPLinkOrganizationalUnit
Объект групповой политики связан с подразделением.
lParam
Предоставленные пользователем данные.
pNext
Указатель на следующий объект групповой политики в списке.
pPrev
Указатель на предыдущий объект групповой политики в списке.
lpExtensions
Расширения, хранящие данные в этом объекте групповой политики. Формат представляет собой строку GUID, сгруппированных в квадратные скобки. Дополнительные сведения см. в следующем разделе "Примечания".
lParam2
Предоставленные пользователем данные.
lpLink
Путь к сайту Active Directory, домену или подразделению организации, к которому связан этот объект групповой политики. Если объект групповой политики связан с локальным объектом групповой политики, этот элемент имеет значение "Local".
Замечания
Каждый объект групповой политики может содержать данные, которые должны обрабатываться несколькими расширениями оснастки. Таким образом, данные в lpExtensions член организованы в виде ряда GUID, которые определяют расширения и расширения оснастки. Формат данных выглядит следующим образом:
[ext_guid1, snap_in_guid1, snap_in_guid2, ...]
[ext_guid2, snap_in_guid3, snap_in_guid4, ...]
Во-первых, есть открываемая скобка "[", за которой следует GUID расширения. Затем вы найдете один или несколько идентификаторов GUID GUID, определяющих расширения оснастки, хранящие данные в объекте групповой политики. После последней оснастки GUID расширения есть закрывающая скобка "]". Этот шаблон повторяется для следующего расширения.
Заметка
Заголовок userenv.h определяет GROUP_POLICY_OBJECT как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| заголовка | userenv.h |