Edit

IEventControl::SetPublisherFilter method (eventsys.h)

  • Article

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

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

IEventControl