组策略 API

组策略 API 技术概述。

若要开发组策略 API，需要以下标头：

• gpedit.h

有关此技术的编程指南，请参阅：

• 组策略 API

枚举

INSTALLSPECTYPE INSTALLSPECTYPE 枚举值定义将组策略应用程序指定到 InstallApplication 函数的方式。 这些值在 INSTALLDATA 的 Type 成员中使用。

函数

BrowseForGPO BrowseForGPO 函数创建允许用户打开或创建 GPO 的 GPO 浏览器对话框。
CreateGPOLink CreateGPOLink 函数在指定的 GPO 与指定的站点、域或组织单位之间创建链接。
删除 Delete 方法删除 GPO。
DeleteAllGPOLinks DeleteAllGPOLinks 函数删除指定站点、域或组织单位的所有 GPO 链接。
DeleteGPOLink DeleteGPOLink 函数删除指定 GPO 与指定站点、域或组织单位之间的链接。
EnterCriticalPolicySection EnterCriticalPolicySection 函数暂停策略的应用，以允许应用程序安全地读取策略设置。
ExportRSoPData ExportRSoPData 函数将包含 RSoP 信息的 WMI 命名空间导出到数据文件。 函数将信息写入数据文件，该文件可通过调用 ImportRSoPData 函数导入 WMI 命名空间。
FreeGPOListA FreeGPOList 函数释放指定的 GPO 列表。 (ANSI)
FreeGPOListW FreeGPOList 函数释放指定的 GPO 列表。 (Unicode)
GetAppliedGPOListA GetAppliedGPOList 函数检索为指定用户或计算机应用的 GPO 列表。 (ANSI)
GetAppliedGPOListW GetAppliedGPOList 函数检索为指定用户或计算机应用的 GPO 列表。 (Unicode)
GetDisplayName GetDisplayName 方法检索 GPO 的显示名称。 (IGPEInformation.GetDisplayName)
GetDisplayName GetDisplayName 方法检索 GPO 的显示名称。 (IGroupPolicyObject.GetDisplayName)
GetDSPath GetDSPath 方法检索 GPO 的指定节的 Active Directory 路径。
GetDSPath GetDSPath 方法检索指定 GPO 节根目录的 Active Directory 路径。
GetEventLogEntryText GetEventLogEntryText 方法返回事件日志中特定条目的文本。
GetFileSysPath GetFileSysPath 方法返回 GPO 的指定节的文件系统路径。 路径采用 UNC 格式。
GetFileSysPath GetFileSysPath 方法检索指定 GPO 节根目录的文件系统路径。 路径采用 UNC 格式。
GetFlags GetFlags 方法检索有关 RSoP 用户界面会话的信息。
GetGPOListA GetGPOList 函数检索指定用户或计算机的 GPO 列表。 (ANSI)
GetGPOListW GetGPOList 函数检索指定用户或计算机的 GPO 列表。 (Unicode)
GetHint GetHint 方法检索此 GPO 可以链接到的 Active Directory 对象的类型。
GetLocalManagedApplications 可以在目标计算机上运行 GetLocalManagedApplications 函数，以获取该计算机上的托管应用程序列表。
GetMachineName GetMachineName 方法检索远程 GPO 的计算机名称。 这是 OpenRemoteMachineGPO 方法指定的名称。
GetManagedApplicationCategories GetManagedApplicationCategories 函数获取域的应用程序类别列表。 该列表对于域中的所有用户都是相同的。
GetManagedApplications GetManagedApplications 函数获取显示在指定用户上下文的“添加/删除程序 (ARP) ”的“添加”窗格中的应用程序列表。
GetName GetName 方法检索 GPO 的唯一名称。 此值通常是 GUID。
GetName GetName 方法检索唯一的 GPO 名称。
GetNamespace GetNameSpace 方法检索要从中显示 RSoP 数据的命名空间。
GetOptions GetOptions 方法检索用户为组策略对象编辑器选择的选项。
GetOptions GetOptions 方法检索 GPO 的选项。
GetPath GetPath 方法检索 GPO 的路径。
GetPropertySheetPages GetPropertySheetPages 方法检索与 GPO 关联的属性表页。
GetRegistryKey GetRegistryKey 方法检索 GPO 指定节的注册表项根的句柄。
GetRegistryKey GetRegistryKey 方法检索指定 GPO 节的注册表项根的句柄。
GetType GetType 方法检索要编辑的 GPO 的类型信息。 (IGPEInformation.GetType)
GetType GetType 方法检索正在编辑的 GPO 的类型信息。 (IGroupPolicyObject.GetType)
ImportRSoPData ImportRSoPData 函数将包含 RSoP 数据的数据文件导入 WMI 命名空间。 该文件必须是通过调用 ExportRSoPData 函数生成的文件。
InstallApplication InstallApplication 函数可以安装已部署到属于域的目标用户的应用程序。
LeaveCriticalPolicySection LeaveCriticalPolicySection 函数恢复策略的后台应用。 此函数关闭策略节的句柄。
新建 New 方法使用指定的显示名称在 Active Directory 中创建一个新的 GPO。 方法使用 OpenDSGPO 方法打开 GPO。
OpenDSGPO OpenDSGPO 方法打开指定的 GPO，并选择性地加载注册表信息。
OpenLocalMachineGPO OpenLocalMachineGPO 方法打开计算机的默认 GPO，并选择性地加载注册表信息。
OpenRemoteMachineGPO OpenRemoteMachineGPO 方法打开指定远程计算机的默认 GPO，并选择性地加载注册表信息。
PFNGENERATEGROUPPOLICY GenerateGroupPolicy 回调函数是应用程序定义的回调函数，在计划模式下生成 RSoP 数据时，每个策略扩展都必须导出该回调函数。
PFNPROCESSGROUPPOLICY ProcessGroupPolicy 函数是应用策略时使用的应用程序定义的回调函数。
PFNPROCESSGROUPPOLICYEX ProcessGroupPolicyEx 函数是应用策略时使用的应用程序定义的回调函数。
PFNSTATUSMESSAGECALLBACK StatusMessageCallback 函数是应用程序定义的回调函数，用于在应用策略时显示状态消息。
PolicyChanged PolicyChanged 方法通知组策略对象编辑器策略设置已更改。
ProcessGroupPolicyCompleted ProcessGroupPolicyCompleted 函数通知系统指定的扩展已完成应用策略。
ProcessGroupPolicyCompletedEx ProcessGroupPolicyCompletedEx 函数通知系统指定的策略扩展已完成应用策略。 函数还会报告策略的结果集 (RSoP) 日志记录的状态。
RefreshPolicy RefreshPolicy 函数会导致策略立即应用于客户端计算机。
RefreshPolicyEx RefreshPolicyEx 函数会导致立即在计算机上应用策略。 扩展函数允许指定要应用的策略刷新的类型。
RegisterGPNotification RegisterGPNotification 函数使应用程序能够在策略发生更改时接收通知。 发生策略更改时，指定的事件对象将设置为信号状态。
RsopAccessCheckByType RSoPAccessCheckByType 函数确定安全描述符是否向由 RSOPTOKEN 标识的客户端授予一组指定的访问权限。
RsopFileAccessCheck RSoPFileAccessCheck 函数确定文件的安全描述符是否向由 RSOPTOKEN 标识的客户端授予一组指定的文件访问权限。
RsopResetPolicySettingStatus RSoPResetPolicySettingStatus 函数取消RSOP_PolicySettingStatus实例与其RSOP_PolicySetting实例的链接。
RsopSetPolicySettingStatus RSoPSetPolicySettingStatus 函数创建 RSOP_PolicySettingStatus 实例和 RSOP_PolicySettingLink 实例。 函数 (将) RSOP_PolicySettingStatus 关联到其RSOP_PolicySetting实例。
保存 Save 方法将指定的注册表策略设置保存到磁盘，并更新 GPO 的修订号。
SetDisplayName SetDisplayName 方法设置 GPO 的显示名称。
SetOptions SetOptions 方法设置 GPO 的选项。
UninstallApplication UninstallApplication 函数卸载使用 Windows Installer .msi 文件来处理安装和安装的组策略应用程序。
UnregisterGPNotification UnregisterGPNotification 函数从接收策略更改通知中注销指定的策略通知句柄。

接口

IGPEInformation IGPEInformation 接口提供 Microsoft 管理控制台 (MMC) 扩展管理单元的方法，以便与组策略对象编辑器进行通信。 有关 MMC 的详细信息，请参阅 Microsoft 管理控制台。
IGroupPolicyObject IGroupPolicyObject 接口提供了直接创建和修改 GPO 的方法，而无需使用组策略对象编辑器。
IRSOPInformation IRSOPInformation 接口为 Microsoft 管理控制台 (MMC) 扩展管理单元提供方法，以便与策略 (RSoP) 管理单元main Resultant Set 进行通信。 有关 MMC 的详细信息，请参阅 Microsoft 管理控制台。

结构

GPOBROWSEINFO GPOBROWSEINFO 结构包含 BrowseForGPO 函数用于初始化 GPO 浏览器对话框的信息。 用户关闭对话框后，系统将返回有关用户在此结构中的操作的信息。
GROUP_POLICY_OBJECTA GROUP_POLICY_OBJECT 结构提供有关 GPO 列表中 GPO 的信息。 (ANSI)
GROUP_POLICY_OBJECTW GROUP_POLICY_OBJECT 结构提供有关 GPO 列表中 GPO 的信息。 (Unicode)
INSTALLDATA INSTALLDATA 结构指定要由 InstallApplication 安装的组策略应用程序。
INSTALLSPEC INSTALLSPEC 结构按组策略应用程序的用户友好名称和组策略 GUID 或其文件扩展名指定。 INSTALLDATA 结构的 Spec 成员向 InstallApplication 函数提供此信息。
LOCALMANAGEDAPPLICATION LOCALMANAGEDAPPLICATION 结构描述为用户或计算机安装的托管应用程序。 由 GetLocalManagedApplications 函数返回。
MANAGEDAPPLICATION MANAGEDAPPLICATION 结构包含有关应用程序的信息。 函数 GetManagedApplications 返回 MANAGEDAPPLICATION 结构的数组。
POLICYSETTINGSTATUSINFO POLICYSETTINGSTATUSINFO 结构提供有关策略设置事件的信息。
RSOP_TARGET RSOP_TARGET 结构包含 GenerateGroupPolicy 函数所需的计算机和用户信息。