Sur cette page

QSslKey Class

La classe QSslKey fournit une interface pour les clés privées et publiques. En savoir plus...

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()

Crée une clé nulle.

Voir aussi isNull().

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

Crée un objet QSslKey à partir d'une clé native valide handle. Le paramètre ` type ` indique si la clé est publique ou privée.

QSslKey prendra en charge cette clé et vous ne devez pas la libérer à 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())

Crée un objet QSslKey en lisant et en décodant les données d'un fichier « device » à l'aide d'un format « algorithm » et « encoding » spécifiés. Le paramètre « type » indique si la clé est publique ou privée.

Si la clé est chiffrée, la méthode passPhrase est utilisée pour la déchiffrer.

Une fois la clé générée, 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())

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

Si la clé est chiffrée, la méthode passPhrase est utilisée pour la déchiffrer.

Une fois la clé générée, utilisez ` isNull()` pour vérifier si ` encoded ` contient une clé valide.

QSslKey::QSslKey(const QSslKey &other)

Crée une copie identique de other.

[noexcept] QSslKey::~QSslKey()

Supprime l'objet « QSslKey ».

QSsl::KeyAlgorithm QSslKey::algorithm() const

Renvoie l'algorithme de clé.

void QSslKey::clear()

Efface le contenu de cette clé, ce qui en fait une clé vide.

Voir également isNull().

Qt::HANDLE QSslKey::handle() const

Renvoie un pointeur vers le descripteur natif de la clé, s'il existe, sinon ` nullptr`.

Vous pouvez utiliser ce descripteur avec l’API native pour accéder à des informations détaillées sur la clé.

Avertissement : l'utilisation de cette fonction présente un risque élevé de non-portabilité, et sa valeur de retour peut varier d'une plateforme à l'autre, ainsi qu'entre les versions mineures de Qt.

bool QSslKey::isNull() const

Renvoie « true » si la clé est nulle ; sinon, renvoie « 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)

Remplace cette clé SSL par celle disponible à l'adresse other. Cette opération est très rapide et ne rencontre jamais de problème.

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

Renvoie la clé au format DER.

L'argument « passPhrase » doit être omis, car le format DER ne peut pas être chiffré. Il sera supprimé dans une future version de Qt.

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

Renvoie la clé au format PEM. Le résultat est chiffré à l'aide de 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é (c'est-à-dire PublicKey ou PrivateKey).

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

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

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

Copie le contenu de other dans cette clé, rendant ainsi 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.