Sur cette page

QSslKey Class

La classe QSslKey fournit une interface pour les clés privées et publiques. Plus d'informations...

En-tête : #include <QSslKey>
CMake : find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake : QT += network

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

QSslKey()
QSslKey(Qt::HANDLE handle, QSsl::KeyType type = QSsl::PrivateKey)
QSslKey(QIODevice *device, QSsl::KeyAlgorithm algorithm, QSsl::EncodingFormat encoding = QSsl::Pem, QSsl::KeyType type = QSsl::PrivateKey, const QByteArray &passPhrase = QByteArray())
QSslKey(const QByteArray &encoded, QSsl::KeyAlgorithm algorithm, QSsl::EncodingFormat encoding = QSsl::Pem, QSsl::KeyType type = QSsl::PrivateKey, const QByteArray &passPhrase = QByteArray())
QSslKey(const QSslKey &other)
~QSslKey()
QSsl::KeyAlgorithm algorithm() const
void clear()
Qt::HANDLE handle() const
bool isNull() const
int length() const
void swap(QSslKey &other)
QByteArray toDer(const QByteArray &passPhrase = QByteArray()) const
QByteArray toPem(const QByteArray &passPhrase = QByteArray()) const
QSsl::KeyType type() const
bool operator!=(const QSslKey &other) const
QSslKey &operator=(const QSslKey &other)
bool operator==(const QSslKey &other) const

Description détaillée

QSslKey fournit une API simple pour la gestion des clés.

Voir également QSslSocket, QSslCertificate, et QSslCipher.

Documentation des fonctions membres

QSslKey::QSslKey()

Construit une clé nulle.

Voir aussi isNull().

[explicit] QSslKey::QSslKey(Qt::HANDLE handle, QSsl::KeyType type = QSsl::PrivateKey)

Construit une QSslKey à partir d'une clé native valide handle. type précise si la clé est publique ou privée.

QSslKey devient propriétaire de cette clé et vous ne devez pas libérer la clé à l'aide de la bibliothèque native.

QSslKey::QSslKey(QIODevice *device, QSsl::KeyAlgorithm algorithm, QSsl::EncodingFormat encoding = QSsl::Pem, QSsl::KeyType type = QSsl::PrivateKey, const QByteArray &passPhrase = QByteArray())

Construit une QSslKey en lisant et en décodant les données d'une device en utilisant un format spécifié algorithm et encoding. type spécifie si la clé est publique ou privée.

Si la clé est cryptée, passPhrase est utilisé pour la décrypter.

Après la construction, utilisez isNull() pour vérifier si device a fourni une clé valide.

QSslKey::QSslKey(const QByteArray &encoded, QSsl::KeyAlgorithm algorithm, QSsl::EncodingFormat encoding = QSsl::Pem, QSsl::KeyType type = QSsl::PrivateKey, const QByteArray &passPhrase = QByteArray())

Construit une QSslKey en décodant la chaîne contenue dans le tableau d'octets encoded à l'aide d'un format spécifié algorithm et encoding. type spécifie si la clé est publique ou privée.

Si la clé est cryptée, passPhrase est utilisé pour la décrypter.

Après la construction, utilisez isNull() pour vérifier si encoded contient une clé valide.

QSslKey::QSslKey(const QSslKey &other)

Construit une copie identique de other.

[noexcept] QSslKey::~QSslKey()

Détruit l'objet QSslKey.

QSsl::KeyAlgorithm QSslKey::algorithm() const

Renvoie l'algorithme de la clé.

void QSslKey::clear()

Efface le contenu de cette clé, la transformant en clé nulle.

Voir aussi isNull().

Qt::HANDLE QSslKey::handle() const

Renvoie un pointeur sur l'identifiant de la clé native, s'il y en a un, sinon nullptr.

Vous pouvez utiliser cet identifiant avec l'API native pour accéder à des informations étendues sur la clé.

Attention : L'utilisation de cette fonction a une forte probabilité d'être non portable, et sa valeur de retour peut varier d'une plateforme à l'autre, et entre les versions mineures de Qt.

bool QSslKey::isNull() const

Renvoie true s'il s'agit d'une clé nulle, sinon false.

Voir aussi clear().

int QSslKey::length() const

Renvoie la longueur de la clé en bits, ou -1 si la clé est nulle.

[noexcept] void QSslKey::swap(QSslKey &other)

Échange cette clé ssl avec other. Cette opération est très rapide et n'échoue jamais.

QByteArray QSslKey::toDer(const QByteArray &passPhrase = QByteArray()) const

Renvoie la clé en encodage DER.

L'argument passPhrase doit être omis car le DER ne peut pas être crypté. Il sera supprimé dans une prochaine version de Qt.

QByteArray QSslKey::toPem(const QByteArray &passPhrase = QByteArray()) const

Renvoie la clé en encodage PEM. Le résultat est chiffré avec passPhrase si la clé est une clé privée et si passPhrase n'est pas vide.

QSsl::KeyType QSslKey::type() const

Renvoie le type de la clé (PublicKey ou PrivateKey).

bool QSslKey::operator!=(const QSslKey &other) const

Renvoie true si cette clé n'est pas égale à la clé other; sinon, renvoie false.

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

Copie le contenu de other dans cette clé, rendant les deux clés identiques.

Renvoie une référence à cette clé QSslKey.

bool QSslKey::operator==(const QSslKey &other) const

Renvoie true si cette clé est égale à other; sinon, renvoie false.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.