FreeGPOListA-Funktion (userenv.h)

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

Syntax

USERENVAPI BOOL FreeGPOListA(
  [in] PGROUP_POLICY_OBJECTA pGPOList
);

Parameter

[in] pGPOList

Ein Zeiger auf die Liste der Gruppenrichtlinienobjektstrukturen. Diese Liste wird von der GetGPOList- oder GetAppliedGPOList-Funktion 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 die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, 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