GROUP_POLICY_OBJECTW结构 (userenv.h)

项目
08/26/2023

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

语法

typedef struct _GROUP_POLICY_OBJECTW {
  DWORD                        dwOptions;
  DWORD                        dwVersion;
  LPWSTR                       lpDSPath;
  LPWSTR                       lpFileSysPath;
  LPWSTR                       lpDisplayName;
  WCHAR                        szGPOName[50];
  GPO_LINK                     GPOLink;
  LPARAM                       lParam;
  struct _GROUP_POLICY_OBJECTW *pNext;
  struct _GROUP_POLICY_OBJECTW *pPrev;
  LPWSTR                       lpExtensions;
  LPARAM                       lParam2;
  LPWSTR                       lpLink;
} GROUP_POLICY_OBJECTW, *PGROUP_POLICY_OBJECTW;

成员

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 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。