GROUP_POLICY_OBJECTW-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_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;

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 von 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 Mitglied "Lokal".

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 GUIDsorganisiert, 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, ...]

Zuerst gibt es eine öffnende Klammer, "[", gefolgt von der GUID der Erweiterung. Als Nächstes finden Sie eine oder mehrere GUIDs, die die Snap-In-Erweiterungen identifizieren, die Daten im Gruppenrichtlinienobjekt gespeichert haben. Nach der letzten Snap-In-GUID für eine Erweiterung befindet sich die 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 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.