MMCPropertyChangeNotify function (mmc.h)

Article
10/13/2021

The MMCPropertyChangeNotify function enables a snap-in property sheet to notify its IComponent or IComponentData interface that an item's properties have changed.

Property sheets run in a different thread than their IComponent and IComponentData server; therefore, if param is a COM interface pointer, it must be marshaled. Asynchronously calling this function notifies the IComponent or the IComponentData associated with the property page whose properties have changed.

Syntax

HRESULT MMCPropertyChangeNotify(
  [in] LONG_PTR lNotifyHandle,
  [in] LPARAM   param
);

Parameters

[in] lNotifyHandle

A value that specifies the handle used to route the notification message to the appropriate IComponent or IComponentData.

[in] param

User-defined. Can be used freely.

Return value

This callback function can return one of these values.

Remarks

This is the handle passed to IExtendPropertySheet2::CreatePropertyPages.

A call to MMCPropertyChangeNotify causes an MMCN_PROPERTY_CHANGE notification to be sent to the snap-in.

The param value that is passed to MMCPropertyChangeNotify is, in turn, forwarded to the snap-in as the param argument to MMCN_PROPERTY_CHANGE.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	mmc.h