createGPOLink 函式 (gpedit.h)

CreateGPOLink 函式會在指定的 GPO 與指定的網站、網域或組織單位之間建立連結。

語法

GPEDITAPI HRESULT CreateGPOLink(
  [in] LPOLESTR lpGPO,
  [in] LPOLESTR lpContainer,
  [in] BOOL     fHighPriority
);

[in] lpGPO

值，指定 GPO 的路徑，格式為 ADSI 格式 (“LDAP://cn=user， ou=users， dc=coname， dc=com”) 。您無法在此參數中指定伺服器名稱。

[in] lpContainer

值，指定月臺、網域或組織單位的 Active Directory 路徑。

[in] fHighPriority

值，指定連結優先順序。如果此參數為 TRUE，系統會建立連結作為最高優先順序。如果此參數為 FALSE，系統會將連結建立為最低優先順序。

如果函式成功，傳回值 會S_OK。否則，函式會傳回頭檔 WinError.h 中定義的其中一個 COM 錯誤碼。請注意，您應該明確測試傳回值 S_OK。請勿在傳回的 HRESULT 上使用 SUCCEEDED 或 FAILED 宏來判斷函式的成功或失敗。