CreateGPOLink-Funktion (gpedit.h)
Die CreateGPOLink-Funktion erstellt eine Verbindung zwischen dem angegebenen Gruppenrichtlinienobjekt und der angegebenen Website, Domäne oder Organisationseinheit.
Syntax
GPEDITAPI HRESULT CreateGPOLink(
[in] LPOLESTR lpGPO,
[in] LPOLESTR lpContainer,
[in] BOOL fHighPriority
);
Parameter
[in] lpGPO
Ein Wert, der den Pfad zum Gruppenrichtlinienobjekt im ADSI-Format angibt ("LDAP://cn=user, ou=users, dc=coname, dc=com"). Sie können keinen Servernamen in diesem Parameter angeben.
[in] lpContainer
Ein Wert, der den Active Directory-Pfad zum Standort, der Domäne oder der Organisationseinheit angibt.
[in] fHighPriority
Ein Wert, der die Linkpriorität angibt. Wenn dieser Parameter TRUE ist, erstellt das System den Link als höchste Priorität. Wenn dieser Parameter FALSE ist, erstellt das System den Link als niedrigste Priorität.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Funktion einen der COM-Fehlercodes zurück, die in der Headerdatei WinError.h definiert sind. Beachten Sie, dass Sie explizit auf den Rückgabewert S_OK testen sollten. Verwenden Sie nicht das Makro SUCCEEDED oder FAILED für das zurückgegebene HRESULT , um den Erfolg oder Fehler der Funktion zu bestimmen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | gpedit.h |
| Bibliothek | GPEdit.lib |
| DLL | GPEdit.dll |