QAuthenticator class provides an authentication object. 更多...
| 头： | #include <QAuthenticator> |
| qmake: | QT += network |
| Since: | Qt 4.3 |
注意： 此类的所有函数 可重入 .
| QAuthenticator () | |
| QAuthenticator (const QAuthenticator & other ) | |
| ~QAuthenticator () | |
| bool | isNull () const |
| QVariant | option (const QString & opt ) const |
| QVariantHash | options () const |
| QString | password () const |
| QString | realm () const |
| void | setOption (const QString & opt , const QVariant & value ) |
| void | setPassword (const QString & password ) |
| void | setUser (const QString & user ) |
| QString | user () const |
| bool | operator!= (const QAuthenticator & other ) const |
| QAuthenticator & | operator= (const QAuthenticator & other ) |
| bool | operator== (const QAuthenticator & other ) const |
QAuthenticator class provides an authentication object.
QAuthenticator class is usually used in the authenticationRequired() and proxyAuthenticationRequired() signals of QNetworkAccessManager and QAbstractSocket . The class provides a way to pass back the required authentication information to the socket when accessing services that require authentication.
QAuthenticator supports the following authentication methods:
In addition to the username and password required for authentication, a QAuthenticator object can also contain additional options. The options () function can be used to query incoming options sent by the server; the setOption () function can be used to set outgoing options, to be processed by the authenticator calculation. The options accepted and provided depend on the authentication type (see method()).
The following tables list known incoming options as well as accepted outgoing options. The list of incoming options is not exhaustive, since servers may include additional information at any time. The list of outgoing options is exhaustive, however, and no unknown options will be treated or sent back to the server.
| 选项 | Direction | 类型 | 描述 |
|---|---|---|---|
realm
|
Incoming | QString | Contains the realm of the authentication, the same as realm () |
The Basic authentication mechanism supports no outgoing options.
The NTLM authentication mechanism currently supports no incoming or outgoing options. On Windows, if no user has been set, domain\user credentials will be searched for on the local system to enable Single-Sign-On functionality.
| 选项 | Direction | 类型 | 描述 |
|---|---|---|---|
realm
|
Incoming | QString | Contains the realm of the authentication, the same as realm () |
The Digest-MD5 authentication mechanism supports no outgoing options.
另请参阅 QSslSocket .
Constructs an empty authentication object.
构造副本为 other .
Destructs the object.
返回
true
if the object has not been initialized. Returns
false
if non-const member functions have been called, or the content was constructed or copied from another initialized
QAuthenticator
对象。
Returns the value related to option opt if it was set by the server. See the Options section for more information on incoming options. If option opt isn't found, an invalid QVariant 将被返回。
该函数在 Qt 4.7 引入。
另请参阅 setOption (), options ()，和 QAuthenticator options .
Returns all incoming options set in this QAuthenticator object by parsing the server reply. See the Options section for more information on incoming options.
该函数在 Qt 4.7 引入。
另请参阅 option () 和 QAuthenticator options .
返回用于身份验证的口令。
另请参阅 setPassword ().
Returns the realm requiring authentication.
Sets the outgoing option opt to value value 。见 Options section for more information on outgoing options.
该函数在 Qt 4.7 引入。
另请参阅 options (), option ()，和 QAuthenticator options .
设置 password used for authentication.
另请参阅 password () 和 QNetworkAccessManager::authenticationRequired ().
设置 user used for authentication.
另请参阅 user () 和 QNetworkAccessManager::authenticationRequired ().
Returns the user used for authentication.
另请参阅 setUser ().
返回
true
if this authenticator is different from
other
；否则返回
false
.
Assigns the contents of other to this authenticator.
返回
true
if this authenticator is identical to
other
；否则返回
false
.
