MMCN_PASTE message

The MMCN_PASTE notification message is sent to a snap-in's IComponent implementation to tell the snap-in's scope item to paste the selected result items.

Parameters

lpDataObject

The data object of the destination scope item in which to paste the selected items provided by the snap-in.

arg

The data object of the selected item(s) provided by the source snap-in that must be pasted.

param

NULL for copy (as opposed to cut).

LPDATAOBJECT* ppDataObj = (LPDATAOBJECT*)param.

Use this to return a pointer to a data object consisting of the items successfully pasted. This data object is in turn forwarded to the source snap-in through the MMCN_CUTORMOVE notification.

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 the items to be pasted were cut or moved from the source, the snap-in has the responsibility to return a data object that identifies those items that were successfully pasted. This is so the source snap-in can know which items it can delete. If all items are successfully pasted the snap-in can simply increment the reference count on the input data object (by calling its AddRef method) and then return it.

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

Mmc.h

See also

MMCN_CUTORMOVE
Drag and Drop
Multiselection

 

 

Show: