GetAppliedGPOListW, fonction (userenv.h)
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 a la valeur NULL, le nom de l’ordinateur local est utilisé.
[in] pSidUser
Valeur qui spécifie le SID de l’utilisateur. Si pMachineName n’a pas la valeur NULL et que dwFlags spécifie la stratégie utilisateur, pSidUser ne peut pas être NULL.
Si pMachineName a la valeur NULL et que pSidUser a la valeur NULL, l’utilisateur est l’utilisateur actuellement connecté. Si pMachineName a la valeur NULL et que 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’objet de stratégie de groupe. Pour plus d’informations, consultez GROUP_POLICY_OBJECT.
Valeur retournée
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 d’objets de stratégie de groupe lorsque vous avez terminé de la traiter, appelez la fonction FreeGPOList .
Notes
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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | userenv.h |
| Bibliothèque | Userenv.lib |
| DLL | Userenv.dll |