gloox  1.0.9
Public Member Functions | List of all members
RegistrationHandler Class Reference

#include <registrationhandler.h>

Public Member Functions

virtual ~RegistrationHandler ()
virtual void handleRegistrationFields (const JID &from, int fields, std::string instructions)=0
virtual void handleAlreadyRegistered (const JID &from)=0
virtual void handleRegistrationResult (const JID &from, RegistrationResult regResult)=0
virtual void handleDataForm (const JID &from, const DataForm &form)=0
virtual void handleOOB (const JID &from, const OOB &oob)=0

Detailed Description

A virtual interface that receives events from an Registration object.

Derived classes can be registered as RegistrationHandlers with an Registration object. Incoming results for operations initiated through the Registration object are forwarded to this handler.

Author
Jakob Schroeter js@ca.nosp@m.maya.nosp@m..net
Since
0.2

Definition at line 77 of file registrationhandler.h.

Constructor & Destructor Documentation

virtual ~RegistrationHandler ( )
inlinevirtual

Virtual Destructor.

Definition at line 83 of file registrationhandler.h.

Member Function Documentation

virtual void handleAlreadyRegistered ( const JID from)
pure virtual

This function is called if Registration::createAccount() was called on an authenticated stream and the server lets us know about this.

virtual void handleDataForm ( const JID from,
const DataForm form 
)
pure virtual

This function is called additionally to handleRegistrationFields() if the server supplied a data form together with legacy registration fields.

Parameters
fromThe server or service the data form came from.
formThe DataForm containing registration information.
virtual void handleOOB ( const JID from,
const OOB oob 
)
pure virtual

This function is called if the server does not offer in-band registration but wants to refer the user to an external URL.

Parameters
fromThe server or service the referal came from.
oobThe OOB object describing the external URL.
virtual void handleRegistrationFields ( const JID from,
int  fields,
std::string  instructions 
)
pure virtual

Reimplement this function to receive results of the Registration::fetchRegistrationFields() function.

Parameters
fromThe server or service the registration fields came from.
fieldsThe OR'ed fields the server requires. From Registration::fieldEnum.
instructionsAny additional information the server sends along.
virtual void handleRegistrationResult ( const JID from,
RegistrationResult  regResult 
)
pure virtual

This funtion is called to notify about the result of an operation.

Parameters
fromThe server or service the result came from.
regResultThe result of the last operation.

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