II3IDHandler::ChangeInitiator Method

Synopsis

This method changes the Initiator of the handler. An initiator is always the first step in a handler. It tells Interaction Processor which event starts an instance of that handler.

When one of the modules in CIC, such as Telephony Services, generates an event, Notifier sees the event and tells other modules about that event. One of these modules is Interaction Processor, where the handlers are registered. When the Notifier tells the Interaction Processor about an event, Interaction Processor starts an instance of a handler.

When you publish a handler, the handler's initiator tells Interaction Processor which event to watch for. An event is something that happens to an object. For example, a call (object) can be sent to voice mail (event). If you configure an initiator in a handler to start when calls are sent to voice mail, then Interaction Processor starts that handler any time it is notified of that event.

NOTE: Subroutine initiators are different from other initiators because they are started by a call from another handler instead of an event that occurs on the CIC system. See the Subroutine initiator documentation for more information.

IDL Function Prototype

HRESULT ChangeInitiator(

   [in] VARIANT NewInitiator

);

C/C++ Syntax

HRESULT ChangeInitiator(VARIANT NewInitiator);

Parameters

NewInitiator

NewInitiator can be a VT_UNKNOWN or VT_DISPATCH interface pointer to an existing II3IDInitiator object or a VT_BSTR identifying the initiator by name.