MMCN_ADD_IMAGES message

The MMCN_ADD_IMAGES notification message is sent to the snap-in's IComponent implementation to add images for the result pane. MMC provides a pointer to the IImageList interface when this notification message is sent to the snap-in.

Parameters

lpDataObject [in]

A pointer to the data object of the currently selected scope item.

arg

A pointer to the result pane image list (IImageList). This pointer is valid only while the specific MMCN_ADD_IMAGES notification is being processed and should not be stored for later use. Additionally, the snap-in must not call the Release method of IImageList because MMC must release it.

param

A value that specifies the HSCOPEITEM of the currently selected scope item. The snap-in can use this parameter to add images that apply specifically to the result items of this scope item, or the snap-in can ignore this parameter and add all possible images.

Return value

S_OK

The snap-in successfully handled the notification.

S_FALSE

The snap-in does not handle the notification. MMC then performs a default operation for the notification.

Remarks

The primary snap-in should add images for both folders and leaf items. Extension snap-ins should add only folder images. A snap-in must load and destroy its image bitmap each time it responds to a MMCN_ADD_IMAGES notification; failure to do so can result in undesirable results if the user changes display settings.

Requirements

See also

IComponent::Notify

IComponentData::Notify

IExtendControlbar::ControlbarNotify

IImageList