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 列表之後釋出 GPO 清單,請呼叫 FreeGPOList 函式。
注意
userenv.h 標頭會將 GetAppliedGPOList 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | userenv.h |
程式庫 | Userenv.lib |
Dll | Userenv.dll |