getAppliedGPOListA 函数 (userenv.h)
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 |