PushTechnology.ClientInterface.Client.Callbacks.ITopicTreeHandler Interface Reference

The interface for callback handlers that establish a server side control presence for the client ISession at a particular branch of the topic tree. More...

Inheritance diagram for PushTechnology.ClientInterface.Client.Callbacks.ITopicTreeHandler:

Public Member Functions
void	OnRegistered (string topicPath, IRegistration registration)
	Called when the handler has been successfully registered with the server. More...
void	OnClose (string topicPath)
	Called if the handler is closed. More...
void	OnError (string topicPath, ErrorReason errorReason)
	Notification of a contextual error related to this handler. More...

Detailed Description

The interface for callback handlers that establish a server side control presence for the client ISession at a particular branch of the topic tree.

Since 5.1

Member Function Documentation

void PushTechnology.ClientInterface.Client.Callbacks.ITopicTreeHandler.OnClose

(

string

topicPath

)

Called if the handler is closed.

The handler will be closed if the session is closed after the handler has been registered, or if the handler is unregistered using IRegistration.Close().

No further calls will be made for the handler.

Parameters

topicPath

The branch of the topic tree for which the handler was registered.

Implemented in PushTechnology.ClientInterface.Client.Callbacks.DefaultTopicTreeHandler.

void PushTechnology.ClientInterface.Client.Callbacks.ITopicTreeHandler.OnError	(	string	topicPath,
		ErrorReason	errorReason
	)

Notification of a contextual error related to this handler.

Situations in which this method is called include the session being closed before the handler is registered, a communication timeout, or a problem with the provided parameters.

No further calls will be made to this handler.

Parameters

topicPath	The branch of the topic tree for which the handler was registered.
errorReason	The reason for the error.

Implemented in PushTechnology.ClientInterface.Client.Callbacks.DefaultTopicTreeHandler, and PushTechnology.ClientInterface.Client.Features.Control.Topics.TopicControlEventListenerDefault.

void PushTechnology.ClientInterface.Client.Callbacks.ITopicTreeHandler.OnRegistered	(	string	topicPath,
		IRegistration	registration
	)

Called when the handler has been successfully registered with the server.

A session can register a single handler of each type for a given branch of the topic tree. If there is already a handler registered for the topic path the operation will fail, registration will be closed, and the session error handler will be notified. To change the handler, first close the previous handler via IRegistration.Close().

Parameters

topicPath	The path that the handler is active for.
registration	The registration that is able to close the handler.

Implemented in PushTechnology.ClientInterface.Client.Callbacks.DefaultTopicTreeHandler, and PushTechnology.ClientInterface.Client.Features.Control.Topics.TopicControlEventListenerDefault.

---

The documentation for this interface was generated from the following file:

• Client.Public/Callbacks/ITopicTreeHandler.cs