GROUP_POLICY_OBJECTA-Struktur (userenv.h)

Artikel
08/26/2023

Die GROUP_POLICY_OBJECT-Struktur stellt Informationen zu einem Gruppenrichtlinienobjekt in einer Gruppenrichtlinienobjektliste bereit.

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;

Member

dwOptions

Gibt Linkoptionen an. Dieser Member 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

Zeiger auf eine Zeichenfolge, die den Pfad zum Verzeichnisdienstteil des Gruppenrichtlinienobjekts angibt.

lpFileSysPath

Zeiger auf eine Zeichenfolge, die den Pfad zum Dateisystemteil des Gruppenrichtlinienobjekts angibt.

lpDisplayName

Zeiger auf den Anzeigenamen des Gruppenrichtlinienobjekts.

szGPOName[50]

Zeiger auf eine Zeichenfolge, die einen eindeutigen Namen angibt, der das Gruppenrichtlinienobjekt identifiziert.

GPOLink

Gibt die Linkinformationen für das Gruppenrichtlinienobjekt an. Dieser Member 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

Zeiger auf das nächste Gruppenrichtlinienobjekt in der Liste.

pPrev

Zeiger auf das vorherige Gruppenrichtlinienobjekt in der Liste.

lpExtensions

Erweiterungen, die Daten in diesem Gruppenrichtlinienobjekt gespeichert haben. Das Format ist eine Zeichenfolge der GUIDin 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 organization Einheit, mit der dieses Gruppenrichtlinienobjekt verknüpft ist. Wenn das Gruppenrichtlinienobjekt mit dem lokalen Gruppenrichtlinienobjekt verknüpft ist, lautet dieses Element "Local".

Hinweise

Jedes Gruppenrichtlinienobjekt kann Daten enthalten, die von mehreren Snap-In-Erweiterungen verarbeitet werden müssen. Daher sind die Daten im lpExtensions-Member als eine Reihe von GUID-Instanzenorganisiert, 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 mindestens eine GUID, die die Snap-In-Erweiterungen identifiziert, die Daten im Gruppenrichtlinienobjekt gespeichert haben. Nach der letzten Snap-In-GUID für eine Erweiterung gibt es eine schließende Klammer, "]". Dieses Muster wird für die nächste Erweiterung wiederholt.

Hinweis

Der Header userenv.h definiert GROUP_POLICY_OBJECT als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.