MMCPropertyChangeNotify callback function

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 STDAPICALLTYPE MMCPropertyChangeNotify(
  _In_ LONG_PTR lNotifyHandle,
  _In_ LPARAM   param
);

Parameters

lNotifyHandle [in]

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

param [in]

User-defined. Can be used freely.

Return value

This callback function can return one of these values.

S_OK

Notification was sent.

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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

See also

IComponent
IExtendPropertySheet2
MMCFreeNotifyHandle

 

 

Show: