FreeGPOListW-Funktion (userenv.h)

Die FreeGPOList-Funktion gibt die angegebene Liste der Gruppenrichtlinienobjekte frei.

Syntax

USERENVAPI BOOL FreeGPOListW(
  [in] PGROUP_POLICY_OBJECTW pGPOList
);

Parameter

[in] pGPOList

Ein Zeiger auf die Liste der Gruppenrichtlinienobjektstrukturen. Diese Liste wird von der Funktion GetGPOList oder GetAppliedGPOList zurückgegeben. Weitere Informationen finden Sie unter GROUP_POLICY_OBJECT.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der userenv.h-Header definiert FreeGPOList als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	userenv.h
Bibliothek	Userenv.lib
DLL	Userenv.dll

Weitere Informationen

GROUP_POLICY_OBJECT

GetAppliedGPOList

GetGPOList

Gruppenrichtlinie-Funktionen

Übersicht über Gruppenrichtlinien