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
);

Parameters

[in] classFilter

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

Return value

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.

Remarks

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.

Requirements

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

See also

IMultiInterfaceEventControl