structure GROUP_POLICY_OBJECTA (userenv.h)
La structure GROUP_POLICY_OBJECT fournit des informations sur un objet de stratégie de groupe dans une liste d’objets de stratégie de groupe.
Syntaxe
typedef struct _GROUP_POLICY_OBJECTA {
DWORD dwOptions;
DWORD dwVersion;
LPSTR lpDSPath;
LPSTR lpFileSysPath;
LPSTR lpDisplayName;
CHAR szGPOName[50];
GPO_LINK GPOLink;
LPARAM lParam;
struct _GROUP_POLICY_OBJECTA *pNext;
struct _GROUP_POLICY_OBJECTA *pPrev;
LPSTR lpExtensions;
LPARAM lParam2;
LPSTR lpLink;
} GROUP_POLICY_OBJECTA, *PGROUP_POLICY_OBJECTA;
Membres
dwOptions
Spécifie les options de lien. Ce membre peut être l’une des valeurs suivantes.
GPO_FLAG_DISABLE
Cet objet de stratégie de groupe est désactivé.
GPO_FLAG_FORCE
Ne remplacez pas les paramètres de stratégie de cet objet de stratégie par des paramètres de stratégie dans un objet de stratégie suivant.
dwVersion
Spécifie le numéro de version de l’objet de stratégie de groupe.
lpDSPath
Pointeur vers une chaîne qui spécifie le chemin d’accès à la partie du service d’annuaire de l’objet de stratégie de groupe.
lpFileSysPath
Pointeur vers une chaîne qui spécifie le chemin d’accès à la partie système de fichiers de l’objet de stratégie de groupe.
lpDisplayName
Pointeur vers le nom complet de l’objet de stratégie de groupe.
szGPOName[50]
Pointeur vers une chaîne qui spécifie un nom unique qui identifie l’objet de stratégie de groupe.
GPOLink
Spécifie les informations de lien pour l’objet de stratégie de groupe. Ce membre peut être l’une des valeurs suivantes.
GPLinkUnknown
Aucune information de lien n’est disponible.
GPLinkMachine
L’objet de stratégie de groupe est lié à un ordinateur (local ou distant).
GPLinkSite
L’objet de stratégie de groupe est lié à un site.
GPLinkDomain
L’objet de stratégie de groupe est lié à un domaine.
GPLinkOrganizationalUnit
L’objet de stratégie de groupe est lié à une unité organisationnelle.
lParam
Données fournies par l’utilisateur.
pNext
Pointeur vers l’objet de stratégie de groupe suivant dans la liste.
pPrev
Pointeur vers l’objet de stratégie de groupe précédent dans la liste.
lpExtensions
Extensions qui ont stocké des données dans cet objet de stratégie de groupe. Le format est une chaîne de GUIDs regroupés entre crochets. Pour plus d’informations, consultez la section Remarques suivante.
lParam2
Données fournies par l’utilisateur.
lpLink
Chemin d’accès au site, au domaine ou à l’unité d’organisation Active Directory auquel cet objet de stratégie de groupe est lié. Si l’objet de stratégie de groupe est lié à l’objet de stratégie de groupe local, ce membre est « Local ».
Remarques
Chaque objet de stratégie de groupe peut contenir des données qui doivent être traitées par plusieurs extensions de composant logiciel enfichable. Par conséquent, les données du membre lpExtensions sont organisées sous la forme d’une série de GUIDs qui identifient les extensions et les extensions de composant logiciel enfichable. Le format de données est le suivant :
[ext_guid1, snap_in_guid1, snap_in_guid2, ...]
[ext_guid2, snap_in_guid3, snap_in_guid4, ...]
Tout d’abord, il existe un crochet ouvrant, « [ », suivi du GUID de l’extension. Ensuite, vous trouverez un ou plusieurs GUIDidentifiant les extensions de composant logiciel enfichable qui ont stocké des données dans l’objet de stratégie de groupe. Après le dernier composant logiciel enfichable GUID pour une extension, il existe un crochet fermant , « ] ». Ce modèle est répété pour l’extension suivante.
Note
L’en-tête userenv.h définit GROUP_POLICY_OBJECT en tant qu’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 |
| d’en-tête | userenv.h |