MMCN_FILTER_CHANGE message

The MMCN_FILTER_CHANGE notification is introduced in MMC 1.2.

The MMCN_FILTER_CHANGE notification message is sent to the snap-in's IComponent implementation when the filter value for a filtered result view column has been changed.

MMC calls IComponent::Notify with the MMCN_FILTER_CHANGE notification as the event parameter when filtering has been enabled or disabled, or when the filter value of a particular column has changed.

Parameters

lpDataObject [in]

Not used (NULL).

arg [in]

Filter change code (see MMC_FILTER_CHANGE_CODE enumeration).

param [in]

Column number of changed value, if change code is MFCC_VALUE_CHANGE.

Return value

S_OK

The snap-in successfully handled the notification.

S_FALSE

The snap-in does not handle the notification.

Remarks

The snap-in receives an MMCN_FILTER_CHANGE notification with the arg parameter set to MFCC_ENABLE when the user clicks the Filtered menu item or the snap-in programmatically sets the view mode to filtered view by setting the MMC_VIEW_OPTIONS_FILTERED option in the IComponent::GetResultViewType method.

The snap-in receives an MMCN_FILTER_CHANGE notification with the arg parameter set to MFCC_DISABLE when the user or the snap-in turns off filtering.

Requirements

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

See also

IComponent::Notify

IHeaderCtrl2

MMC_FILTER_CHANGE_CODE

Adding Filtered Views