Interface IServerHandler

Common interface for callback handlers that establish a server side control presence for the client ISession.

Namespace: PushTechnology.ClientInterface.Client.Callbacks

Assembly: Diffusion.Client.dll

Syntax

public interface IServerHandler

Methods

OnClose()

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 close.

No further calls will be made for the handler.

Declaration

void OnClose()

OnError(ErrorReason)

Notification of a contextual error related to this handler. This is analogous to an unchecked exception being raised. Situations in which onError 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.

Declaration

void OnError(ErrorReason errorReason)

Parameters

Type	Name	Description
ErrorReason	errorReason	a value representing the error; this can be one of constants defined in ErrorReason, or a feature-specific reason

OnRegistered(IRegistration)

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

A session can register at most one a single handler of each type. If there is already a handler registered the operation will fail, registeredHandler will be closed, and the session error handler will be notified. To change the handler, first close the previous handler.

Declaration

void OnRegistered(IRegistration registration)

Parameters

Type	Name	Description
IRegistration	registration	reference that allows the handler to be closed