GetAppliedGPOListA-Funktion (userenv.h)

Artikel
03/03/2024

Die GetAppliedGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte 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 wird, ruft die Funktion nur Benutzerrichtlinieninformationen ab.

[in] pMachineName

Ein Zeiger auf den Namen des Remotecomputers. Das Format des Namens ist "\\computer_name". Wenn dieser Parameter NULL ist, wird der lokale Computername 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 sein.

Wenn pMachineNameNULL und pSidUserNULL ist, ist der Benutzer der aktuell angemeldete Benutzer. Wenn pMachineNameNULL 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 Gruppenrichtlinienobjektstrukturen 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 in der Headerdatei WinError.h.

Hinweise

Rufen Sie die Funktion FreeGPOList auf, um die Gruppenrichtlinienobjektliste nach Abschluss der Verarbeitung frei zu geben.

Hinweis

Der userenv.h-Header 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 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