MMCN_REMOVE_CHILDREN message

The MMCN_REMOVE_CHILDREN notification message is sent to the snap-in's IComponentData::Notify method to inform the snap-in that it must delete all the child items (the entire subtree) it has added below the specified item.

Parameters

lpDataObject [in]

A pointer to the data object of the scope item whose child items need to be removed.

arg

A value that specifies the HSCOPEITEM of the item whose child items need to be deleted.

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

The snap-in may use IConsoleNameSpace2::GetChildItem and IConsoleNameSpace2::GetNextItem to traverse the tree and determine the child items to be deleted.

The snap-in is only required to release its own resources for the deleted child items. It is not required to call IConsoleNameSpace2::DeleteItem to cause MMC to delete the items.

Requirements

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

See also

IComponentData::Notify