GROUP_POLICY_OBJECTA Struktur (userenv.h)
Die GROUP_POLICY_OBJECT Struktur enthält Informationen zu einem Gruppenrichtlinienobjekt in einer Gruppenrichtlinienobjektliste.
Syntax
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;
Angehörige
dwOptions
Gibt Verknüpfungsoptionen an. Dieses Element kann einer der folgenden Werte sein:
GPO_FLAG_DISABLE
Dieses Gruppenrichtlinienobjekt ist deaktiviert.
GPO_FLAG_FORCE
Überschreiben Sie die Richtlinieneinstellungen in diesem Gruppenrichtlinienobjekt nicht mit Richtlinieneinstellungen in einem nachfolgenden Gruppenrichtlinienobjekt.
dwVersion
Gibt die Versionsnummer des Gruppenrichtlinienobjekts an.
lpDSPath
Zeigen Sie auf eine Zeichenfolge, die den Pfad zum Verzeichnisdienstteil des Gruppenrichtlinienobjekts angibt.
lpFileSysPath
Zeigen Sie auf eine Zeichenfolge, die den Pfad zum Dateisystemteil des Gruppenrichtlinienobjekts angibt.
lpDisplayName
Zeigen Sie auf den Anzeigenamen des Gruppenrichtlinienobjekts.
szGPOName[50]
Zeigen Sie auf eine Zeichenfolge, die einen eindeutigen Namen angibt, der das Gruppenrichtlinienobjekt identifiziert.
GPOLink
Gibt die Linkinformationen für das Gruppenrichtlinienobjekt an. Dieses Element kann einer der folgenden Werte sein.
GPLinkUnknown
Es sind keine Linkinformationen verfügbar.
GPLinkMachine
Das Gruppenrichtlinienobjekt ist mit einem Computer (lokal oder remote) verknüpft.
GPLinkSite
Das Gruppenrichtlinienobjekt ist mit einer Website verknüpft.
GPLinkDomain
Das Gruppenrichtlinienobjekt ist mit einer Domäne verknüpft.
GPLinkOrganizationalUnit
Das Gruppenrichtlinienobjekt ist mit einer Organisationseinheit verknüpft.
lParam
Vom Benutzer bereitgestellte Daten.
pNext
Zeigen Sie auf das nächste Gruppenrichtlinienobjekt in der Liste.
pPrev
Zeigen Sie auf das vorherige Gruppenrichtlinienobjekt in der Liste.
lpExtensions
Erweiterungen, die Daten in diesem Gruppenrichtlinienobjekt gespeichert haben. Das Format ist eine Zeichenfolge GUID-in Klammern gruppiert. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
lParam2
Vom Benutzer bereitgestellte Daten.
lpLink
Pfad zum Active Directory-Standort, zur Domäne oder zur Organisationseinheit, mit der dieses Gruppenrichtlinienobjekt verknüpft ist. Wenn das Gruppenrichtlinienobjekt mit dem lokalen Gruppenrichtlinienobjekt verknüpft ist, lautet dieses Mitglied "Local".
Bemerkungen
Jedes Gruppenrichtlinienobjekt kann Daten enthalten, die von mehreren Snap-In-Erweiterungen verarbeitet werden müssen. Daher werden die Daten in den lpExtensions Member als eine Reihe von GUID-organisiert, die die Erweiterungen und Snap-In-Erweiterungen identifizieren. Das Datenformat lautet wie folgt:
[ext_guid1, snap_in_guid1, snap_in_guid2, ...]
[ext_guid2, snap_in_guid3, snap_in_guid4, ...]
Zunächst gibt es eine öffnende Klammer "[", gefolgt von der GUID- der Erweiterung. Als Nächstes finden Sie eine oder mehrere GUID-, die die Snap-In-Erweiterungen identifizieren, die Daten im Gruppenrichtlinienobjekt gespeichert haben. Nach dem letzten Snap-In-GUID- für eine Erweiterung gibt es eine schließende Klammer "]". Dieses Muster wird für die nächste Erweiterung wiederholt.
Anmerkung
Der Header "userenv.h" definiert GROUP_POLICY_OBJECT 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 |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Header- | userenv.h |