Share via


MMCN_PRELOAD message

The MMCN_PRELOAD notification is introduced in MMC 1.1.

The MMCN_PRELOAD notification message is sent to the snap-in's IComponentData implementation if the snap-in returned TRUE when MMC called IDataObject::GetDataHere with the CCF_SNAPIN_PRELOADS format.

Parameters

lpDataObject [in]

A pointer to the data object of the static node of the snap-in being preloaded.

arg [in]

HSCOPEITEM of the static node of the snap-in being preloaded.

param

Not used.

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

When a console file is saved, MMC calls IDataObject::GetDataHere on each loaded snap-in using the CCF_SNAPIN_PRELOADS clipboard format. If the snap-in handles the CCF_SNAPIN_PRELOADS clipboard format and returns TRUE, MMC calls the IComponentData::Notify method of the snap-in with the MMCN_PRELOAD notification when the snap-in's parent is first selected. If a preload is not requested, MMC does not load a snap-in until the snap-in's static node is selected. Until then MMC displays a cached icon and name for the snap-in's static node.

The preloaded snap-in can handle this notification by performing any actions required before it displays its static node or its child items (for example, a dynamic name for an item based on context such as a file name or computer name).

Requirements

Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Header
Mmc.h

See also

IComponentData::Notify

CCF_SNAPIN_PRELOADS