CreateGPOLink, fonction (gpedit.h)
La fonction CreateGPOLink crée un lien entre l’objet de stratégie de groupe spécifié et le site, le domaine ou l’unité d’organisation spécifié.
Syntaxe
GPEDITAPI HRESULT CreateGPOLink(
[in] LPOLESTR lpGPO,
[in] LPOLESTR lpContainer,
[in] BOOL fHighPriority
);
Paramètres
[in] lpGPO
Valeur qui spécifie le chemin d’accès à l’objet de stratégie de groupe, au format ADSI (« LDAP://cn=utilisateur, ou=users, dc=coname, dc=com »). Vous ne pouvez pas spécifier un nom de serveur dans ce paramètre.
[in] lpContainer
Valeur qui spécifie le chemin Active Directory du site, du domaine ou de l’unité d’organisation.
[in] fHighPriority
Valeur qui spécifie la priorité du lien. Si ce paramètre a la valeur TRUE, le système crée le lien comme priorité la plus élevée. Si ce paramètre a la valeur FALSE, le système crée le lien comme priorité la plus basse.
Valeur retournée
Si la fonction réussit, la valeur de retour est S_OK. Sinon, la fonction retourne l’un des codes d’erreur COM définis dans le fichier d’en-tête WinError.h. N’oubliez pas que vous devez tester explicitement la valeur de retour S_OK. N’utilisez pas la macro SUCCEEDED ou FAILED sur le HRESULT retourné pour déterminer la réussite ou l’échec de la fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | gpedit.h |
| Bibliothèque | GPEdit.lib |
| DLL | GPEdit.dll |