QObexAuthenticationChallenge Class Reference
[QtBaseModule]

Detailed Description

The QObexAuthenticationChallenge class contains a received OBEX authentication challenge and allows the receiver to set a username and password that should be used for authentication.

This class is used in the QObexClientSession::authenticationRequired() and QObexServerSession::authenticationRequired() signals to pass on the data from a received OBEX authentication challenge. The programmer can then call setUser() and setPassword() to specify the username and password that should be returned in the authentication response.

See also QObexClientSession, QObexServerSession, and QObexAuthenticationResponse.

Member Function Documentation

QObexAuthenticationChallenge::QObexAuthenticationChallenge ()

Constructs an empty authentication challenge.

QObexAuthenticationChallenge::QObexAuthenticationChallenge ( const QObexAuthenticationChallenge & other )

Constructs an authentication challenge with the contents from other.

QObexAuthenticationChallenge::~QObexAuthenticationChallenge ()

Destroys the challenge.

QObex::AuthChallengeOptions QObexAuthenticationChallenge::options () const

Returns the authentication options specified by the party that issued the authentication challenge.

QString QObexAuthenticationChallenge::password () const

Returns the password to be used for authentication.

See also setPassword().

QString QObexAuthenticationChallenge::realm () const

Returns the realm specified by the party that issued the authentication challenge. The realm is a user-displayable description that indicates the user and/or password to be used for authentication.

void QObexAuthenticationChallenge::setPassword ( const QString & password )

Sets the password to be used for authentication to password.

See also password().

void QObexAuthenticationChallenge::setUser ( const QString & userName )

Sets the username to be used for authentication to userName.

Warning: The username must not be longer than 20 characters long, or authentication will fail.

See also user().

QString QObexAuthenticationChallenge::user () const

Returns the username to be used for authentication.

See also setUser().

QObexAuthenticationChallenge & QObexAuthenticationChallenge::operator= ( const QObexAuthenticationChallenge & other )

Assigns the contents of other to this object and returns a reference to this challenge.