GetAppliedGPOListW-Funktion (userenv.h)

Artikel
03/13/2024

Die GetAppliedGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte ab, die für den angegebenen Benutzer oder Computer angewendet wurden.

Syntax

USERENVAPI DWORD GetAppliedGPOListW(
  [in]  DWORD                 dwFlags,
  [in]  LPCWSTR               pMachineName,
  [in]  PSID                  pSidUser,
  [in]  GUID                  *pGuidExtension,
  [out] PGROUP_POLICY_OBJECTW *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 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 sein.

Wenn pMachineNameNULL und pSidUserNULL ist, ist der Benutzer der derzeit angemeldete Benutzer. Wenn pMachineNameNULL und pSidUser nicht NULL ist, wird der Benutzer auf dem lokalen Computer durch pSidUser dargestellt. Weitere Informationen finden Sie unter Sicherheits-IDs.

[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 frei zu geben, wenn Sie die Verarbeitung abgeschlossen haben.

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 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