IGPEInformation::P olicyChanged-Methode (gpedit.h)

Die PolicyChanged-Methode informiert den Gruppenrichtlinie Objekt-Editor, dass sich die Richtlinieneinstellungen geändert haben.

Syntax

HRESULT PolicyChanged(
  [in] BOOL bMachine,
  [in] BOOL bAdd,
  [in] GUID *pGuidExtension,
  [in] GUID *pGuidSnapin
);

Parameter

[in] bMachine

Gibt an, ob sich die Computer- oder Benutzerrichtlinie geändert hat. Wenn dieser Wert TRUE ist, hat sich die Computerrichtlinie geändert. Wenn dieser Wert FALSE ist, wurde die Benutzerrichtlinie geändert.

[in] bAdd

Gibt an, ob es sich um einen Add- oder Delete-Vorgang handelt. Wenn dieser Parameter FALSE ist, wird die letzte Richtlinieneinstellung für die angegebene Erweiterung pGuidExtension entfernt. In allen anderen Fällen ist dieser Parameter TRUE.

[in] pGuidExtension

Zeiger auf die GUID oder den eindeutigen Namen der Snap-In-Erweiterung, die die Richtlinie verarbeitet. Wenn das Gruppenrichtlinienobjekt von dem Snap-In verarbeitet werden soll, das POL-Dateien verarbeitet, muss dieser Parameter den REGISTRY_EXTENSION_GUID Wert angeben.

[in] pGuidSnapin

Zeiger auf die GUID oder den eindeutigen Namen der Snap-In-Erweiterung, die diese Methode aufruft.

Rückgabewert

Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der COM-Fehlercodes zurück, die in der Platform SDK-Headerdatei WinError.h definiert sind.

Hinweise

Eine Erweiterung muss diese Methode jedes Mal aufrufen, wenn sie eine Änderung an einem Gruppenrichtlinienobjekt vornimmt. Beachten Sie, dass Sie beim Schreiben eines MMC-Snap-Ins die IComponentData-Schnittstelle implementieren und die IComponentData::Notify-Methode aufrufen müssen. Um die IGPEInformation-Schnittstelle abzurufen, legen Sie den Ereignisparameter der IComponentData::Notify-Methodeauf MMCN_EXPAND und den arg-Parameter auf TRUE fest. Anschließend können Sie die IGPEInformation-Schnittstelle abrufen, indem Sie QueryInterface aufrufen und die üblichen Regeln für die Implementierung von QueryInterface verwenden.

Beispielsweise können Sie die Schnittstelle abrufen, indem Sie wie folgt aufrufen.

lpDataObject->QueryInterface(IID_IGPEInformation, (LPVOID lpDataObject->*)&m_pGPTInformation);

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	gpedit.h
DLL	Gpedit.dll

Weitere Informationen

Gruppenrichtlinie Schnittstellen

Übersicht über Gruppenrichtlinien

IGPEInformation