IGroupPolicyObject::New-Methode (gpedit.h)
Die New-Methode erstellt ein neues Gruppenrichtlinienobjekt im Active Directory mit dem angegebenen Anzeigenamen. Die -Methode öffnet das Gruppenrichtlinienobjekt mithilfe der OpenDSGPO-Methode .
Syntax
HRESULT New(
[in] LPOLESTR pszDomainName,
[in] LPOLESTR pszDisplayName,
[in] DWORD dwFlags
);
Parameter
[in] pszDomainName
Gibt den Active Directory-Pfad des zu erstellenden Objekts an. Wenn der Pfad einen Domänencontroller angibt, wird das Gruppenrichtlinienobjekt auf diesem Domänencontroller erstellt. Andernfalls wählt das System einen DC im Namen des Aufrufers aus.
[in] pszDisplayName
Gibt den Anzeigenamen des zu erstellenden Objekts an.
[in] dwFlags
Gibt an, ob die Registrierungsinformationen für das Gruppenrichtlinienobjekt geladen werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.
GPO_OPEN_LOAD_REGISTRY
Laden Sie die Registrierungsinformationen.
GPO_OPEN_READ_ONLY
Öffnen Sie das Gruppenrichtlinienobjekt im schreibgeschützten Modus.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der COM-Fehlercodes zurück, die in der Platform SDK-Headerdatei WinError.h definiert sind.
Hinweise
Um ein bereits vorhandenes Gruppenrichtlinienobjekt zu öffnen, können Sie die OpenDSGPO-Methode aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | gpedit.h |
| DLL | Gpedit.dll |
Weitere Informationen
Gruppenrichtlinie Schnittstellen