AMPS.Client.Authenticator Interface Reference

Inheritance diagram for AMPS.Client.Authenticator:

Public Member Functions
String	authenticate (String username_, String currentPassword_)
	Called by AMPS.Client, just before the logon command is seny. More...
String	retry (String username_, String password_)
	Called when a logon "ack" is received with a status of "retry". More...
void	completed (String username_, String password_, Message.Reasons reason_)
	Called when a logon completes successfully. More...

Member Function Documentation

authenticate()

String AMPS.Client.Authenticator.authenticate	(	String	username_,
		String	currentPassword_
	)

Called by AMPS.Client, just before the logon command is seny.

Parameters

username_	The current value of the username as specified in the URI.
currentPassword_	The current value of the password, as specified in the URI.

Returns

The value that should be placed into the Password header field of the logon command

Implemented in AMPS.Client.DefaultAuthenticator.

completed()

void AMPS.Client.Authenticator.completed	(	String	username_,
		String	password_,
		Message.Reasons	reason_
	)

Called when a logon completes successfully.

Once a logon has completed, this method is called with the username and password that caused a successful logon.

Parameters

username_	The username that successfully logged on to the server.
password_	The password that successfully logged on to the server.
reason_	The reason reported for success by the server.

Implemented in AMPS.Client.DefaultAuthenticator.

retry()

String AMPS.Client.Authenticator.retry	(	String	username_,
		String	password_
	)

Called when a logon "ack" is received with a status of "retry".

AMPS will continue trying to logon as long as the server returns "retry", and this method continues to succeed.

Parameters

username_	The username returned by the server's ACK message.
password_	The password or token returned in the server's ACK message.

Returns

The value that should be placed into the Password header for the next logon attempt.

Implemented in AMPS.Client.DefaultAuthenticator.

---

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

• AMPS.Client/Authenticator.cs