MMCPropertyChangeNotify

[This is preliminary documentation and subject to change.]

MMCPropertyChangeNotify 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 the param is a COM interface pointer, it needs to be marshaled. Making this function call notifies each IComponent or the one IComponentData synchronously.

STDAPI MMCPropertyChangeNotify(
  long INotifyHandle,  // Handle to a notification
  long param           // Unique identifier
);
 

Parameters

INotifyHandle

[in] Specifies the handle used to route the notification message to the appropriate IComponent or IComponentData.

param

[in] User defined and can be used freely.

Return Values

S_OK

Notification was sent.

For more about COM error codes, see the COM and ActiveX Object Services documentation in the Platform SDK.

Remarks

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

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

See Also

IComponent, IExtendPropertySheet, MMCFreeNotifyHandle