Edit

IMultiInterfacePublisherFilter::PrepareToFire method (eventsys.h)

  • Article

Prepares the publisher filter to begin firing a filtered list of subscriptions using a provided firing control. The firing control is contained in the event class object.

Syntax

HRESULT PrepareToFire(
  [in] REFIID         iid,
  [in] BSTR           methodName,
  [in] IFiringControl *firingControl
);

Parameters

[in] iid

The interface ID of the interface being fired.

[in] methodName

The name of the event method to be fired.

[in] firingControl

A pointer to the IFiringControl interface on the firing control object.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Remarks

Prior to invoking the application event interface method, the event object invokes this method one time on the publisher filter for each published event.

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

IMultiInterfacePublisherFilter