Edit

IFiringControl::FireSubscription method (eventsys.h)

  • Article

Fires an event to a single subscriber.

Syntax

HRESULT FireSubscription(
  [in] IEventSubscription *subscription
);

Parameters

[in] subscription

A pointer to the IEventSubscription interface on a subscription object.

Return value

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

Remarks

The FireSubscription method fires an event to the subscriber associated with the subscription object identified by the subscription parameter. A publisher filter typically iterates through a filtered list of subscriptions and calls FireSubscription for each associated subscriber. All standard delivery processing is done by the event object for the subscription, including the following:

  • Any standard parameter filtering.
  • Activating the subscriber object (optional, for persistent subscriptions).
  • Depending on parameter filtering, invoking the event method that originally caused entry into the publisher filter on the subscriber.

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

IFiringControl