Sur cette page

QSslDiffieHellmanParameters Class

La classe `QSslDiffieHellmanParameters` fournit une interface pour les paramètres Diffie-Hellman destinés aux serveurs. En savoir plus...

En-tête : #include <QSslDiffieHellmanParameters>
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.

Types publics

enum Error { NoError, InvalidInputDataError, UnsafeParametersError }

Fonctions publiques

QSslDiffieHellmanParameters()
QSslDiffieHellmanParameters(const QSslDiffieHellmanParameters &other)
QSslDiffieHellmanParameters(QSslDiffieHellmanParameters &&other)
~QSslDiffieHellmanParameters()
QSslDiffieHellmanParameters::Error error() const
QString errorString() const
bool isEmpty() const
bool isValid() const
void swap(QSslDiffieHellmanParameters &other)
QSslDiffieHellmanParameters &operator=(QSslDiffieHellmanParameters &&other)
QSslDiffieHellmanParameters &operator=(const QSslDiffieHellmanParameters &other)

Membres publics statiques

QSslDiffieHellmanParameters defaultParameters()
QSslDiffieHellmanParameters fromEncoded(QIODevice *device, QSsl::EncodingFormat encoding = QSsl::Pem)
QSslDiffieHellmanParameters fromEncoded(const QByteArray &encoded, QSsl::EncodingFormat encoding = QSsl::Pem)
size_t qHash(const QSslDiffieHellmanParameters &key, size_t seed = 0)
bool operator!=(const QSslDiffieHellmanParameters &lhs, const QSslDiffieHellmanParameters &rhs)
QDebug operator<<(QDebug debug, const QSslDiffieHellmanParameters &dhparam)
bool operator==(const QSslDiffieHellmanParameters &lhs, const QSslDiffieHellmanParameters &rhs)

Description détaillée

QSslDiffieHellmanParameters fournit une interface permettant de configurer les paramètres Diffie-Hellman sur les serveurs, conformément à la spécification QSslSocket.

Voir également QSslSocket, QSslCipher et QSslConfiguration.

Documentation sur les types de membres

enum QSslDiffieHellmanParameters::Error

Décrit une erreur « QSslDiffieHellmanParameters ».

ConstanteValeurDescription
QSslDiffieHellmanParameters::NoError0Aucune erreur ne s’est produite.
QSslDiffieHellmanParameters::InvalidInputDataError1Les données d'entrée fournies n'ont pas pu être utilisées pour créer un objet « QSslDiffieHellmanParameters ».
QSslDiffieHellmanParameters::UnsafeParametersError2Les paramètres Diffie-Hellman ne sont pas sécurisés et ne doivent pas être utilisés.

Documentation des fonctions membres

QSslDiffieHellmanParameters::QSslDiffieHellmanParameters()

Crée une instance vide de `QSslDiffieHellmanParameters`.

Si une instance vide de QSslDiffieHellmanParameters est associée à un objet ` QSslConfiguration `, la négociation Diffie-Hellman sera désactivée.

Voir également isValid() et QSslConfiguration.

QSslDiffieHellmanParameters::QSslDiffieHellmanParameters(const QSslDiffieHellmanParameters &other)

Crée une copie identique de other.

[noexcept] QSslDiffieHellmanParameters::QSslDiffieHellmanParameters(QSslDiffieHellmanParameters &&other)

Constructions de déplacement issues de other.

Remarque : l'objet d'origine other est placé dans un état partiellement formé, dans lequel les seules opérations valides sont la destruction et l'affectation d'une nouvelle valeur.

[noexcept] QSslDiffieHellmanParameters::~QSslDiffieHellmanParameters()

Supprime l'objet « QSslDiffieHellmanParameters ».

[static] QSslDiffieHellmanParameters QSslDiffieHellmanParameters::defaultParameters()

Renvoie l'QSslDiffieHellmanParameters par défaut utilisé par QSslSocket.

Il s'agit actuellement du groupe MODP à 2 048 bits défini dans la RFC 3526.

[noexcept] QSslDiffieHellmanParameters::Error QSslDiffieHellmanParameters::error() const

Renvoie l'erreur qui a rendu l'objet ` QSslDiffieHellmanParameters ` non valide.

[noexcept] QString QSslDiffieHellmanParameters::errorString() const

Renvoie une description compréhensible par l'utilisateur de l'erreur qui a rendu l'objet ` QSslDiffieHellmanParameters ` invalide.

[static] QSslDiffieHellmanParameters QSslDiffieHellmanParameters::fromEncoded(QIODevice *device, QSsl::EncodingFormat encoding = QSsl::Pem)

Crée un objet ` QSslDiffieHellmanParameters ` en lisant le fichier ` device `, au format PEM ou DER, conformément à la spécification encoding.

Utilisez la méthode isValid() sur l'objet renvoyé pour vérifier si les paramètres de Diffie-Hellman sont valides et ont été chargés correctement.

En particulier, si device correspond à nullptr ou n’est pas accessible en lecture, un objet non valide sera renvoyé.

Voir également isValid() et QSslConfiguration.

[static] QSslDiffieHellmanParameters QSslDiffieHellmanParameters::fromEncoded(const QByteArray &encoded, QSsl::EncodingFormat encoding = QSsl::Pem)

Crée un objet ` QSslDiffieHellmanParameters ` à partir du tableau d'octets ` encoded `, au format PEM ou DER, conformément à la spécification encoding.

Utilisez la méthode isValid() sur l’objet renvoyé pour vérifier si les paramètres de Diffie-Hellman sont valides et ont été chargés correctement.

Voir également isValid() et QSslConfiguration.

[noexcept] bool QSslDiffieHellmanParameters::isEmpty() const

Renvoie ` true ` s'il s'agit d'une instance vide de ` QSslDiffieHellmanParameters `.

La configuration d’une instance vide de ` QSslDiffieHellmanParameters ` sur un serveur basé sur ` QSslSocket` désactivera l’échange de clés Diffie-Hellman.

[noexcept] bool QSslDiffieHellmanParameters::isValid() const

Renvoie ` true ` si l'objet est valide QSslDiffieHellmanParameters; sinon, renvoie `false`.

Cette méthode doit être utilisée après la création d’un objet ` QSslDiffieHellmanParameters ` afin de vérifier sa validité.

Si un objet ` QSslDiffieHellmanParameters ` n'est pas valide, vous pouvez utiliser la méthode ` error()` pour déterminer quelle erreur a empêché la construction de l'objet.

Voir également error().

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

Remplace cette adresse QSslDiffieHellmanParameters par other. Cette opération est très rapide et ne pose jamais de problème.

[noexcept] QSslDiffieHellmanParameters &QSslDiffieHellmanParameters::operator=(QSslDiffieHellmanParameters &&other)

Cette opération attribue other à cette instance de QSslDiffieHellmanParameters.

Remarque : l’objet d’origine other est placé dans un état partiellement formé, dans lequel les seules opérations valides sont la destruction et l’affectation d’une nouvelle valeur.

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

Copie le contenu de other dans ce QSslDiffieHellmanParameters, rendant ainsi les deux QSslDiffieHellmanParameters identiques.

Renvoie une référence à ce QSslDiffieHellmanParameters.

Éléments non membres associés

[noexcept] size_t qHash(const QSslDiffieHellmanParameters &key, size_t seed = 0)

Renvoie la valeur de hachage de key, en utilisant seed comme graine pour le calcul.

[noexcept] bool operator!=(const QSslDiffieHellmanParameters &lhs, const QSslDiffieHellmanParameters &rhs)

Renvoie ` true ` si ` lhs ` n'est pas égal à ` rhs` ; sinon, renvoie ` false`.

QDebug operator<<(QDebug debug, const QSslDiffieHellmanParameters &dhparam)

Écrit l'ensemble des paramètres Diffie-Hellman sous forme DER ( dhparam ) dans l'objet de débogage debug à des fins de débogage.

Les paramètres Diffie-Hellman seront représentés sous forme DER encodée en Base64.

Voir également Techniques de débogage.

[noexcept] bool operator==(const QSslDiffieHellmanParameters &lhs, const QSslDiffieHellmanParameters &rhs)

Renvoie « true » si « lhs » est égal à « rhs » ; 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.