组策略 API
组策略 API 技术概述。
若要开发组策略 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 函数所需的计算机和用户信息。 |