IMultiInterfacePublisherFilter::PrepareToFire method (eventsys.h)

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

See also

IMultiInterfacePublisherFilter