FreeGPOListA-Funktion (userenv.h)
Die FreeGPOList- Funktion gibt die angegebene Liste der GPOs frei.
Syntax
USERENVAPI BOOL FreeGPOListA(
[in] PGROUP_POLICY_OBJECTA pGPOList
);
Parameter
[in] pGPOList
Ein Zeiger auf die Liste der GPO-Strukturen. 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Anmerkung
Der Header "userenv.h" 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | userenv.h |
| Library | Userenv.lib |
| DLL- | Userenv.dll |