getAppliedGPOListA 函数 (userenv.h)

项目
03/13/2024

GetAppliedGPOList 函数检索应用于指定用户或计算机的 GPO 列表。

语法

USERENVAPI DWORD GetAppliedGPOListA(
  [in]  DWORD                 dwFlags,
  [in]  LPCSTR                pMachineName,
  [in]  PSID                  pSidUser,
  [in]  GUID                  *pGuidExtension,
  [out] PGROUP_POLICY_OBJECTA *ppGPOList
);

参数

[in] dwFlags

一个指定策略类型的值。此参数可以是以下值。

GPO_LIST_FLAG_MACHINE

检索有关计算机策略的信息。

如果未指定此值，则函数仅检索用户策略信息。

[in] pMachineName

指向远程计算机名称的指针。名称的格式为“\\computer_name”。如果此参数为 NULL，则使用本地计算机名称。

[in] pSidUser

一个指定用户的 SID 的值。如果 pMachineName 不为 NULL 且 dwFlags 指定用户策略，则 pSidUser 不能为 NULL。

如果 pMachineName 为 NULL，pSidUser 为 NULL，则用户为当前登录的用户。如果 pMachineName 为 NULL 且 pSidUser 不 为 NULL，则用户由本地计算机上的 pSidUser 表示。有关详细信息，请参阅安全标识符。

[in] pGuidExtension

一个指定扩展的 GUID 的值。

[out] ppGPOList

接收 GPO 结构列表的指针。有关详细信息，请参阅 GROUP_POLICY_OBJECT。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。否则，该函数将返回系统错误代码。有关错误代码的完整列表，请参阅系统错误代码或头文件 WinError.h。

注解

若要在处理完 GPO 列表后释放它，请调用 FreeGPOList 函数。

注意

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

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	userenv.h
Library	Userenv.lib
DLL	Userenv.dll