IGPEInformation::PolicyChanged method (gpedit.h)

Article
02/22/2024

The PolicyChanged method informs the Group Policy Object Editor that policy settings have changed.

Syntax

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

Parameters

[in] bMachine

Specifies whether computer or user policy has changed. If this value is TRUE, computer policy has changed. If this value is FALSE, user policy has changed.

[in] bAdd

Specifies whether this is an add or delete operation. If this parameter is FALSE, the last policy setting for the specified extension pGuidExtension is removed. In all other cases, this parameter is TRUE.

[in] pGuidExtension

Pointer to the GUID or unique name of the snap-in extension that will process policy. If the GPO is to be processed by the snap-in that processes .pol files, this parameter must specify the REGISTRY_EXTENSION_GUID value.

[in] pGuidSnapin

Pointer to the GUID or unique name of the snap-in extension making this method call.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in the Platform SDK header file WinError.h.

Remarks

An extension must call this method every time it makes a change to a group policy object. Note that when you write an MMC snap-in you must implement the IComponentData interface and call the IComponentData::Notify method. To get the IGPEInformation interface, set the event parameter of the IComponentData::Notify method to be MMCN_EXPAND and the arg parameter to TRUE. You can then obtain the IGPEInformation interface by calling QueryInterface and by using the usual Rules for Implementing QueryInterface.

For example, you can obtain the interface by calling as follows.

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

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	gpedit.h
DLL	Gpedit.dll