[This is preliminary documentation and is subject to change.]
Register a global ISubscriber message handler with this agent for the specified SIF object type.
Note agents typically register message handlers with Topics or with Zones
instead of with the Agent. The message dispatcher first
delivers messages to Topics, then to Zones, and finally to the Agent
itself.
In order to receive SIF_Event messages, the agent is expected to be
registered as a ISubscriber of one or more object types in at least one
zone. This method does not send SIF_Subscribe messages to any zones.
| C# | Visual Basic | Visual C++ |
public virtual void SetSubscriber( ISubscriber subscriber, IElementDef objectType )
Public Overridable Sub SetSubscriber ( _ subscriber As ISubscriber, _ objectType As IElementDef _ )
public: virtual void SetSubscriber ( ISubscriber^ subscriber, IElementDef^ objectType )
- subscriber (ISubscriber)
- An object that implements the ISubscriber interface to respond to SIF_Event notifications received by the agent, where the SIF object type referenced by the request matches the specified objectType. This ISubscriber will be called whenever a SIF_Event is received and no other object in the message dispatching chain has processed the message.
- objectType (IElementDef)
- A constant from the SifDtd class that identifies the type of SIF Data Object this ISubscriber will respond to.