GetAppliedGPOListW 函式 (userenv.h)

發行項
03/03/2024

GetAppliedGPOList 函式會擷取套用給指定使用者或計算機的 GPO 清單。

語法

USERENVAPI DWORD GetAppliedGPOListW(
  [in]  DWORD                 dwFlags,
  [in]  LPCWSTR               pMachineName,
  [in]  PSID                  pSidUser,
  [in]  GUID                  *pGuidExtension,
  [out] PGROUP_POLICY_OBJECTW *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