[This is preliminary documentation and is subject to change.]
Register a global IPublisher message handler with the 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_Request messages, the agent is expected to be
registered as a Provider of one or more object types in at least one
zone. This method does not send SIF_Provide messages to any zones.
| C# | Visual Basic | Visual C++ |
public virtual void SetPublisher( IPublisher publisher, IElementDef objectType )
Public Overridable Sub SetPublisher ( _ publisher As IPublisher, _ objectType As IElementDef _ )
public: virtual void SetPublisher ( IPublisher^ publisher, IElementDef^ objectType )
- publisher (IPublisher)
- An object that implements the IPublisher interface to respond to SIF_Request queries received by the agent, where the SIF object type referenced by the request matches the specified objectType. This IPublisher will be called whenever a SIF_Request 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 IPublisher will respond to.