IMultiInterfaceEventControl::SetMultiInterfacePublisherFilter method (eventsys.h)

Assigns a publisher filter to an event method at run time.

This method sets the specified publisher filter for all methods of all event interfaces for the event object.

Syntax

HRESULT SetMultiInterfacePublisherFilter(
  [in] IMultiInterfacePublisherFilter *classFilter
);

[in] classFilter

A pointer to the IMultiInterfacePublisherFilter interface on the publisher filter associated with the specified method.

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following values.

Return code	Description
S_OK	The method completed successfully.
EVENT_E_INTERNALEXCEPTION	An unexpected exception was raised.
EVENT_E_INTERNALERROR	An unexpected internal error was detected.

An event publisher can install a publisher filter at run time to fire an event only to subscribers that meet the criteria specified in the filter.

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	eventsys.h