GetAppliedGPOListW, fonction (userenv.h)

Article
11/20/2024

La fonction GetAppliedGPOList récupère la liste des objets de stratégie de groupe appliqués pour l’utilisateur ou l’ordinateur spécifié.

Syntaxe

USERENVAPI DWORD GetAppliedGPOListW(
  [in]  DWORD                 dwFlags,
  [in]  LPCWSTR               pMachineName,
  [in]  PSID                  pSidUser,
  [in]  GUID                  *pGuidExtension,
  [out] PGROUP_POLICY_OBJECTW *ppGPOList
);

Paramètres

[in] dwFlags

Valeur qui spécifie le type de stratégie. Ce paramètre peut être la valeur suivante.

GPO_LIST_FLAG_MACHINE

Récupère des informations sur la stratégie d’ordinateur.

Si cette valeur n’est pas spécifiée, la fonction récupère uniquement les informations de stratégie utilisateur.

[in] pMachineName

Pointeur vers le nom de l’ordinateur distant. Le format du nom est « \\computer_name». Si ce paramètre est NULL, le nom de l’ordinateur local est utilisé.

[in] pSidUser

Valeur qui spécifie le SID de l’utilisateur. Si pMachineName n’est pas NULL et dwFlags spécifie la stratégie utilisateur, pSidUser ne peut pas être NULL.

Si pMachineName est NULL et pSidUser est NULL, l’utilisateur est l’utilisateur actuellement connecté. Si pMachineName est NULL et pSidUser n’est pas NULL, l’utilisateur est représenté par pSidUser sur l’ordinateur local. Pour plus d’informations, consultez identificateurs de sécurité.

[in] pGuidExtension

Valeur qui spécifie le GUID de l’extension.

[out] ppGPOList

Pointeur qui reçoit la liste des structures d’objets de stratégie de groupe. Pour plus d’informations, consultez GROUP_POLICY_OBJECT.

Valeur de retour

Si la fonction réussit, la valeur de retour est ERROR_SUCCESS. Sinon, la fonction retourne un code d’erreur système. Pour obtenir la liste complète des codes d’erreur, consultez codes d’erreur système ou le fichier d’en-tête WinError.h.

Remarques

Pour libérer la liste des objets de stratégie de groupe lorsque vous avez terminé de le traiter, appelez la fonction FreeGPOList.

Note

L’en-tête userenv.h définit GetAppliedGPOList comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista
serveur minimum pris en charge	Windows Server 2008
plateforme cible	Windows
d’en-tête	userenv.h
bibliothèque	Userenv.lib
DLL	Userenv.dll