GROUP_POLICY_OBJECTA结构（userenv.h）

项目
11/20/2024

GROUP_POLICY_OBJECT 结构提供有关 GPO 列表中的 GPO 的信息。

语法

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 已禁用。

GPO_FLAG_FORCE

不要用后续 GPO 中的策略设置替代此 GPO 中的策略设置。

dwVersion

指定 GPO 的版本号。

lpDSPath

指向指定 GPO 的目录服务部分的路径的字符串的指针。

lpFileSysPath

指向指定 GPO 文件系统部分的路径的字符串的指针。

lpDisplayName

指向 GPO 的显示名称的指针。

szGPOName[50]

指向指定标识 GPO 的唯一名称的字符串的指针。

GPOLink

指定 GPO 的链接信息。此成员可以是以下值之一。

GPLinkUnknown

没有可用的链接信息。

GPLinkMachine

GPO 链接到计算机（本地或远程）。

GPLinkSite

GPO 链接到网站。

GPLinkDomain

GPO 链接到域。

GPLinkOrganizationalUnit

GPO 链接到组织单位。

lParam

用户提供的数据。

pNext

指向列表中的下一个 GPO 的指针。

pPrev

指向列表中上一 GPO 的指针。

lpExtensions

在此 GPO 中存储数据的扩展。格式是 GUID在括号中分组的字符串。有关详细信息，请参阅以下“备注”部分。

lParam2

用户提供的数据。

lpLink

链接到此 GPO 的 Active Directory 站点、域或组织单位的路径。如果 GPO 链接到本地 GPO，则此成员为“Local”。

言论

每个 GPO 可以包含必须由多个管理单元扩展处理的数据。因此，lpExtensions 成员中的数据组织为标识扩展和管理单元扩展的一系列 GUID。数据格式如下所示：

[ext_guid1, snap_in_guid1, snap_in_guid2, ...] 
[ext_guid2, snap_in_guid3, snap_in_guid4, ...]

首先，有一个左括号“[”，后跟扩展 GUID。接下来，你将找到一个或多个 GUID标识已存储在 GPO 中的数据的管理单元扩展。在扩展的最后一个管理单元 GUID 后，有一个右括号“]”。下一个扩展重复此模式。

注意

userenv.h 标头将GROUP_POLICY_OBJECT定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows Vista
支持的最低服务器	Windows Server 2008
标头	userenv.h

另请参阅

通过