GetAppliedGPOListA 函式（userenv.h）

發行項
11/20/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 列表之後釋出 GPO 清單，請呼叫 freeGPOList 函式。

注意

userenv.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetAppliedGPOList 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista
支援的最低伺服器	Windows Server 2008
目標平臺	窗戶
標頭	userenv.h
連結庫	Userenv.lib
DLL	Userenv.dll