IEventControl::SetPublisherFilter method (eventsys.h)

Assigns a publisher filter to an event method.

Syntax

HRESULT SetPublisherFilter(
  [in] BSTR             methodName,
  [in] IPublisherFilter *pPublisherFilter
);

Parameters

[in] methodName

The name of the event method associated with the publisher filter to be assigned.

[in] pPublisherFilter

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

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

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

See also

IEventControl