GetAppliedGPOListA-Funktion (userenv.h)
Die GetAppliedGPOList Funktion ruft die Liste der GPOs ab, die für den angegebenen Benutzer oder Computer angewendet wurden.
Syntax
USERENVAPI DWORD GetAppliedGPOListA(
[in] DWORD dwFlags,
[in] LPCSTR pMachineName,
[in] PSID pSidUser,
[in] GUID *pGuidExtension,
[out] PGROUP_POLICY_OBJECTA *ppGPOList
);
Parameter
[in] dwFlags
Ein Wert, der den Richtlinientyp angibt. Dieser Parameter kann der folgende Wert sein.
GPO_LIST_FLAG_MACHINE
Ruft Informationen zur Computerrichtlinie ab.
Wenn dieser Wert nicht angegeben ist, ruft die Funktion nur Benutzerrichtlinieninformationen ab.
[in] pMachineName
Ein Zeiger auf den Namen des Remotecomputers. Das Format des Namens lautet "\\computer_name". Wenn dieser Parameter NULL-ist, wird der name des lokalen Computers verwendet.
[in] pSidUser
Ein Wert, der die SID des Benutzers angibt. Wenn pMachineName nicht NULL- ist und dwFlags- die Benutzerrichtlinie angibt, kann pSidUser nicht NULL-werden.
Wenn pMachineName-NULL- ist und pSidUser-NULL-ist, ist der Benutzer der aktuell angemeldete Benutzer. Wenn pMachineName-NULL- ist und pSidUser- nicht NULL-ist, wird der Benutzer durch pSidUser- auf dem lokalen Computer dargestellt. Weitere Informationen finden Sie unter Sicherheitsbezeichner.
[in] pGuidExtension
Ein Wert, der die GUID- der Erweiterung angibt.
[out] ppGPOList
Ein Zeiger, der die Liste der GPO-Strukturen empfängt. Weitere Informationen finden Sie unter GROUP_POLICY_OBJECT.
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS. Andernfalls gibt die Funktion einen Systemfehlercode zurück. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes oder der Headerdatei WinError.h.
Bemerkungen
Rufen Sie die FreeGPOList- funktion auf, um die GPO-Liste freizuschalten, wenn Sie die Verarbeitung abgeschlossen haben.
Anmerkung
Der Header "userenv.h" definiert GetAppliedGPOList 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 |