Auf Englisch lesen

Freigeben über


Gruppenrichtlinie-API

Übersicht über die Gruppenrichtlinie-API-Technologie.

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

Programmieranleitungen für diese Technologie finden Sie unter:

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.