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

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

See also

IComponent::Notify
IComponentData::Notify
IExtendControlbar::ControlbarNotify
IImageList

 

 

Show: