GROUP_POLICY_OBJECTW structure (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_OBJECTW {
DWORD dwOptions;
DWORD dwVersion;
LPWSTR lpDSPath;
LPWSTR lpFileSysPath;
LPWSTR lpDisplayName;
WCHAR szGPOName[50];
GPO_LINK GPOLink;
LPARAM lParam;
struct _GROUP_POLICY_OBJECTW *pNext;
struct _GROUP_POLICY_OBJECTW *pPrev;
LPWSTR lpExtensions;
LPARAM lParam2;
LPWSTR lpLink;
} GROUP_POLICY_OBJECTW, *PGROUP_POLICY_OBJECTW;
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 dans cet objet de stratégie de groupe par les paramètres de stratégie dans un objet de stratégie de groupe 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 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é d’organisation.
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 GUIDregroupés entre crochets. Pour plus d'informations, consultez la section Notes qui suit.
lParam2
Données fournies par l’utilisateur.
lpLink
Chemin d’accès au site, domaine ou organization unité 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 GUIDqui 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 y a un crochet ouvrant, « [ », suivi du GUID de l’extension. Ensuite, vous trouverez un ou plusieurs GUIDidentifiant les extensions de composant logiciel enfichable qui ont des données stockées dans l’objet de stratégie de groupe. Après le dernier GUID de composant logiciel enfichable pour une extension, il existe un crochet fermant, « ] ». Ce modèle est répété pour l’extension suivante.
Notes
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. 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
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| En-tête | userenv.h |