QueryRegister Method

This method queries a server for the necessary registration fields.

Syntax

 int QueryRegister(char* lpszXMPPServer);

Remarks

Before a registration can be attempted, the application should use the QueryRegister method to poll the host to which the user wishes to register. This will gather all of the necessary fields that the user must send to the server, and will populate the UserInfo properties accordingly. After a successful query, all entries in UserInfo values will be empty strings.

The possible registration fields are defined in the Jabber protocol specification as follows:


instructions	Special instructions sent from the server.
username	The username to be associated with this account.
password	The initial password for this account.
name	The user's name.
email	The user's email address.
address	The user's physical address.
city	The user's city of residence.
state	The user's state (for United States citizens).
zip	The user's postal code (for United States citizens).
phone	The user's phone number.
URL	The user's website.
date	The date of registration.
misc	Any miscellaneous data.
text	Any extra text (potentially for a personal bio).
remove	Specifies a request to unregister.

After the user has set all of the values in UserInfo, and added any extra fields they may wish to include in their registration, the application should make a call to Register.

If the class is not already connected when this method is called, it will connect, poll the registration fields, and then disconnect.