Gruppenrichtlinie-API

Übersicht über die Gruppenrichtlinie-API-Technologie.

Zum Entwickeln Gruppenrichtlinie-API benötigen Sie die folgenden Header:

• gpedit.h

Programmieranleitungen für diese Technologie finden Sie unter:

• Gruppenrichtlinie-API

Enumerationen

INSTALLSPECTYPE Die INSTALLSPECTYPE-Enumerationswerte definieren, wie eine Gruppenrichtlinienanwendung für die InstallApplication-Funktion angegeben werden kann. Die Werte werden im Type-Member von INSTALLDATA verwendet.

Functions

BrowseForGPO Die BrowseForGPO-Funktion erstellt ein Dialogfeld für den GPO-Browser, in dem der Benutzer ein Gruppenrichtlinienobjekt öffnen oder erstellen kann.
CreateGPOLink Die CreateGPOLink-Funktion erstellt eine Verknüpfung zwischen dem angegebenen Gruppenrichtlinienobjekt und der angegebenen Website, Domäne oder Organisationseinheit.
Löschen Die Delete-Methode löscht das Gruppenrichtlinienobjekt.
DeleteAllGPOLinks Die DeleteAllGPOLinks-Funktion löscht alle GPO-Links für die angegebene Website, Domäne oder Organisationseinheit.
DeleteGPOLink Die DeleteGPOLink-Funktion löscht die Verknüpfung zwischen dem angegebenen Gruppenrichtlinienobjekt und der angegebenen Website, Domäne oder Organisationseinheit.
EnterCriticalPolicySection Die EnterCriticalPolicySection-Funktion hält die Anwendung der Richtlinie an, damit Anwendungen Richtlinieneinstellungen sicher lesen können.
ExportRSoPData Die ExportRSoPData-Funktion exportiert einen WMI-Namespace, der RSoP-Informationen enthält, in eine Datendatei. Die Funktion schreibt die Informationen in eine Datendatei, die mit einem Aufruf der ImportRSoPData-Funktion in einen WMI-Namespace importiert werden kann.
FreeGPOListA Die FreeGPOList-Funktion gibt die angegebene Liste der Gruppenrichtlinienobjekte frei. (ANSI)
FreeGPOListW Die FreeGPOList-Funktion gibt die angegebene Liste der Gruppenrichtlinienobjekte frei. (Unicode)
GetAppliedGPOListA Die GetAppliedGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte ab, die für den angegebenen Benutzer oder Computer angewendet wurden. (ANSI)
GetAppliedGPOListW Die GetAppliedGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte ab, die für den angegebenen Benutzer oder Computer angewendet wurden. (Unicode)
GetDisplayName Die GetDisplayName-Methode ruft den Anzeigenamen für das Gruppenrichtlinienobjekt ab. (IGPEInformation.GetDisplayName)
GetDisplayName Die GetDisplayName-Methode ruft den Anzeigenamen für das Gruppenrichtlinienobjekt ab. (IGroupPolicyObject.GetDisplayName)
GetDSPath Die GetDSPath-Methode ruft den Active Directory-Pfad für den angegebenen Abschnitt des Gruppenrichtlinienobjekts ab.
GetDSPath Die GetDSPath-Methode ruft den Active Directory-Pfad zum Stammverzeichnis des angegebenen Gruppenrichtlinienobjektabschnitts ab.
GetEventLogEntryText Die GetEventLogEntryText-Methode gibt den Text für einen bestimmten Eintrag im Ereignisprotokoll zurück.
GetFileSysPath Die GetFileSysPath-Methode gibt den Dateisystempfad für den angegebenen Abschnitt des Gruppenrichtlinienobjekts zurück. Der Pfad hat das UNC-Format.
GetFileSysPath Die GetFileSysPath-Methode ruft den Dateisystempfad zum Stammverzeichnis des angegebenen Gruppenrichtlinienobjektabschnitts ab. Der Pfad hat das UNC-Format.
GetFlags Die GetFlags-Methode ruft Informationen zur RSoP-Benutzeroberflächensitzung ab.
GetGPOListA Die GetGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte für den angegebenen Benutzer oder Computer ab. (ANSI)
GetGPOListW Die GetGPOList-Funktion ruft die Liste der Gruppenrichtlinienobjekte für den angegebenen Benutzer oder Computer ab. (Unicode)
GetHint Die GetHint-Methode ruft den Typ des Active Directory-Objekts ab, mit dem dieses Gruppenrichtlinienobjekt verknüpft werden kann.
GetLocalManagedApplications Die GetLocalManagedApplications-Funktion kann auf dem Zielcomputer ausgeführt werden, um eine Liste der verwalteten Anwendungen auf diesem Computer abzurufen.
GetMachineName Die GetMachineName-Methode ruft den Computernamen des Remote-Gruppenrichtlinienobjekts ab. Dies ist der Name, der von der OpenRemoteMachineGPO-Methode angegeben wird.
GetManagedApplicationCategories Die GetManagedApplicationCategories-Funktion ruft eine Liste der Anwendungskategorien für eine Domäne ab. Die Liste ist für alle Benutzer in der Domäne identisch.
GetManagedApplications Die GetManagedApplications-Funktion ruft eine Liste der Anwendungen ab, die im Bereich Hinzufügen von Software (ARP) für einen angegebenen Benutzerkontext angezeigt werden.
GetName Die GetName-Methode ruft den eindeutigen Namen für das Gruppenrichtlinienobjekt ab. Dieser Wert ist in der Regel eine GUID.
GetName Die GetName-Methode ruft den eindeutigen Gruppenrichtlinienobjektnamen ab.
GetNamespace Die GetNameSpace-Methode ruft den Namespace ab, aus dem die RSoP-Daten angezeigt werden.
GetOptions Die GetOptions-Methode ruft die Optionen ab, die der Benutzer für den Gruppenrichtlinie-Objekt-Editor ausgewählt hat.
GetOptions Die GetOptions-Methode ruft die Optionen für das Gruppenrichtlinienobjekt ab.
GetPath Die GetPath-Methode ruft den Pfad zum Gruppenrichtlinienobjekt ab.
GetPropertySheetPages Die GetPropertySheetPages-Methode ruft die Eigenschaftenblattseiten ab, die dem Gruppenrichtlinienobjekt zugeordnet sind.
GetRegistryKey Die GetRegistryKey-Methode ruft ein Handle für den Stamm des Registrierungsschlüssels für den angegebenen Abschnitt des Gruppenrichtlinienobjekts ab.
GetRegistryKey Die GetRegistryKey-Methode ruft ein Handle im Stammverzeichnis des Registrierungsschlüssels für den angegebenen GPO-Abschnitt ab.
GetType Die GetType-Methode ruft Typinformationen für das GPO ab, das bearbeitet wird. (IGPEInformation.GetType)
GetType Die GetType-Methode ruft Typinformationen für das zu bearbeitende Gruppenrichtlinienobjekt ab. (IGroupPolicyObject.GetType)
ImportRSoPData Die ImportRSoPData-Funktion importiert eine Datendatei mit RSoP-Daten in einen WMI-Namespace. Die Datei muss durch einen Aufruf der ExportRSoPData-Funktion generiert werden.
InstallApplication Die InstallApplication-Funktion kann Anwendungen installieren, die für Zielbenutzer bereitgestellt wurden, die zu einer Domäne gehören.
LeaveCriticalPolicySection Die LeaveCriticalPolicySection-Funktion setzt die Hintergrundanwendung der Richtlinie fort. Diese Funktion schließt das Handle mit dem Richtlinienabschnitt.
Neu Die New-Methode erstellt ein neues Gruppenrichtlinienobjekt im Active Directory mit dem angegebenen Anzeigenamen. Die -Methode öffnet das Gruppenrichtlinienobjekt mithilfe der OpenDSGPO-Methode.
OpenDSGPO Die OpenDSGPO-Methode öffnet das angegebene Gruppenrichtlinienobjekt und lädt optional die Registrierungsinformationen.
OpenLocalMachineGPO Die OpenLocalMachineGPO-Methode öffnet das Standardrichtlinienobjekt für den Computer und lädt optional die Registrierungsinformationen.
OpenRemoteMachineGPO Die OpenRemoteMachineGPO-Methode öffnet das Standardrichtlinienobjekt für den angegebenen Remotecomputer und lädt optional die Registrierungsinformationen.
PFNGENERATEGROUPPOLICY Die Rückruffunktion GenerateGroupPolicy ist eine anwendungsdefinierte Rückruffunktion, die jede Richtlinienerweiterung exportieren muss, wenn RSoP-Daten im Planungsmodus generiert werden.
PFNPROCESSGROUPPOLICY Die ProcessGroupPolicy-Funktion ist eine anwendungsdefinierte Rückruffunktion, die beim Anwenden von Richtlinien verwendet wird.
PFNPROCESSGROUPPOLICYEX Die ProcessGroupPolicyEx-Funktion ist eine anwendungsdefinierte Rückruffunktion, die beim Anwenden von Richtlinien verwendet wird.
PFNSTATUSMESSAGECALLBACK Die StatusMessageCallback-Funktion ist eine anwendungsdefinierte Rückruffunktion, die zum Anzeigen status Nachrichten beim Anwenden der Richtlinie verwendet wird.
PolicyChanged Die PolicyChanged-Methode informiert den Gruppenrichtlinie Objekt-Editor darüber, dass sich die Richtlinieneinstellungen geändert haben.
ProcessGroupPolicyCompleted Die ProcessGroupPolicyCompleted-Funktion benachrichtigt das System darüber, dass die angegebene Erweiterung die Anwendung der Richtlinie abgeschlossen hat.
ProcessGroupPolicyCompletedEx Die ProcessGroupPolicyCompletedEx-Funktion benachrichtigt das System darüber, dass die angegebene Richtlinienerweiterung die Anwendung der Richtlinie abgeschlossen hat. Die Funktion meldet auch die status der RSoP-Protokollierung (Resultant Set of Policy).
RefreshPolicy Die RefreshPolicy-Funktion bewirkt, dass die Richtlinie sofort auf dem Clientcomputer angewendet wird.
RefreshPolicyEx Die RefreshPolicyEx-Funktion bewirkt, dass die Richtlinie sofort auf dem Computer angewendet wird. Mit der erweiterten Funktion können Sie den Typ der anzuwendenden Richtlinienaktualisierung angeben.
RegisterGPNotification Mit der Funktion RegisterGPNotification kann eine Anwendung Benachrichtigungen empfangen, wenn eine Richtlinie geändert wird. Wenn eine Richtlinienänderung erfolgt, wird das angegebene Ereignisobjekt auf den signalierten Zustand festgelegt.
RsopAccessCheckByType Die RSoPAccessCheckByType-Funktion bestimmt, ob ein Sicherheitsdeskriptor dem von einem RSOPTOKEN identifizierten Client einen angegebenen Satz von Zugriffsrechten gewährt.
RsopFileAccessCheck Die RSoPFileAccessCheck-Funktion bestimmt, ob der Sicherheitsdeskriptor einer Datei einem angegebenen Satz von Dateizugriffsrechten für den client gewährt, der von einem RSOPTOKEN identifiziert wird.
RsopResetPolicySettingStatus Die RSoPResetPolicySettingStatus-Funktion hebt die Verknüpfung des RSOP_PolicySettingStatus instance mit seiner RSOP_PolicySetting instance auf.
RsopSetPolicySettingStatus Die RSoPSetPolicySettingStatus-Funktion erstellt eine instance von RSOP_PolicySettingStatus und eine instance von RSOP_PolicySettingLink. Die Funktion verknüpft (zugeordnet) RSOP_PolicySettingStatus mit ihrem RSOP_PolicySetting instance.
Speichern Die Save-Methode speichert die angegebenen Registrierungsrichtlinieneinstellungen auf dem Datenträger und aktualisiert die Revisionsnummer des Gruppenrichtlinienobjekts.
SetDisplayName Die SetDisplayName-Methode legt den Anzeigenamen für das Gruppenrichtlinienobjekt fest.
SetOptions Die SetOptions-Methode legt die Optionen für das Gruppenrichtlinienobjekt fest.
DeinstallierenAnwendung Die UninstallApplication-Funktion deinstalliert eine Gruppenrichtlinienanwendung, die das Setup und die Installation mithilfe von Windows Installer .msi Dateien übernimmt.
Aufheben der Registrierung vonGPNotification Die Funktion UnregisterGPNotification hebt die Registrierung des angegebenen Richtlinienbenachrichtigungshandles vom Empfang von Richtlinienänderungsbenachrichtigungen auf.

Schnittstellen

IGPEInformation Die IGPEInformation-Schnittstelle stellt Methoden für MMC-Erweiterungs-Snap-Ins (Microsoft Management Console) bereit, um mit dem Gruppenrichtlinie-Objekt-Editor zu kommunizieren. Weitere Informationen zu MMC finden Sie in der Microsoft-Verwaltungskonsole.
IGroupPolicyObject Die IGroupPolicyObject-Schnittstelle bietet Methoden zum direkten Erstellen und Ändern eines Gruppenrichtlinienobjekts, ohne den Gruppenrichtlinie-Objekt-Editor zu verwenden.
IRSOPInformation Die IRSOPInformation-Schnittstelle stellt Methoden für MMC-Erweiterungs-Snap-Ins (Microsoft Management Console) bereit, um mit dem Standard RSoP-Snap-In (Resultant Set of Policy) zu kommunizieren. Weitere Informationen zu MMC finden Sie in der Microsoft-Verwaltungskonsole.

Strukturen

GPOBROWSEINFO Die GPOBROWSEINFO-Struktur enthält Informationen, die die BrowseForGPO-Funktion verwendet, um ein GPO-Browserdialogfeld zu initialisieren. Nachdem der Benutzer das Dialogfeld geschlossen hat, gibt das System Informationen zu den Aktionen des Benutzers in dieser Struktur zurück.
GROUP_POLICY_OBJECTA Die GROUP_POLICY_OBJECT-Struktur stellt Informationen zu einem Gruppenrichtlinienobjekt in einer Gruppenrichtlinienobjektliste bereit. (ANSI)
GROUP_POLICY_OBJECTW Die GROUP_POLICY_OBJECT-Struktur stellt Informationen zu einem Gruppenrichtlinienobjekt in einer Gruppenrichtlinienobjektliste bereit. (Unicode)
INSTALLDATA Die INSTALLDATA-Struktur gibt eine Gruppenrichtlinienanwendung an, die von InstallApplication installiert werden soll.
INSTALLSPEC Die INSTALLSPEC-Struktur gibt eine Gruppenrichtlinienanwendung anhand ihres benutzerfreundlichen Namens und ihrer Gruppenrichtlinien-GUID oder ihrer Dateinamenerweiterung an. Das Spec-Member der INSTALLDATA-Struktur stellt diese Informationen für die InstallApplication-Funktion bereit.
LOCALMANAGEDAPPLICATION Die LOCALMANAGEDAPPLICATION-Struktur beschreibt eine verwaltete Anwendung, die für einen Benutzer oder computer installiert ist. Wird von der GetLocalManagedApplications-Funktion zurückgegeben.
VERWALTETE ANWENDUNG Die MANAGEDAPPLICATION-Struktur enthält Informationen zu einer Anwendung. Die Funktion GetManagedApplications gibt ein Array von MANAGEDAPPLICATION-Strukturen zurück.
POLICYSETTINGSTATUSINFO Die POLICYSETTINGSTATUSINFO-Struktur stellt Informationen zu einem Richtlinieneinstellungsereignis bereit.
RSOP_TARGET Die RSOP_TARGET-Struktur enthält Computer- und Benutzerinformationen, die für die GenerateGroupPolicy-Funktion erforderlich sind.