- Qt 6.7
- Qt Network
- C++ Classes
- QSslDiffieHellmanParameters
- Qt 6.7.3 Reference Documentation

# QSslDiffieHellmanParameters Class

The QSslDiffieHellmanParameters class provides an interface for Diffie-Hellman parameters for servers. More...

Header: | #include <QSslDiffieHellmanParameters>
CMake: | find_package(Qt6 REQUIRED COMPONENTS Network) target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: | QT += network

- List of all members, including inherited members
- QSslDiffieHellmanParameters is part of Network Programming API and Implicitly Shared Classes.

Note: All functions in this class are reentrant.

## Public Types

enum | Error { NoError, InvalidInputDataError, UnsafeParametersError }

## Public Functions

| 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=(const QSslDiffieHellmanParameters &other)
QSslDiffieHellmanParameters & | operator=(QSslDiffieHellmanParameters &&other)

## Static Public Members

QSslDiffieHellmanParameters | defaultParameters()
QSslDiffieHellmanParameters | fromEncoded(const QByteArray &encoded, QSsl::EncodingFormat encoding = QSsl::Pem)
QSslDiffieHellmanParameters | fromEncoded(QIODevice *device, QSsl::EncodingFormat encoding = QSsl::Pem)

## Related Non-Members

size_t | qHash(const QSslDiffieHellmanParameters &dhparam, 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)

## Detailed Description

QSslDiffieHellmanParameters provides an interface for setting Diffie-Hellman parameters to servers based on QSslSocket.

See also QSslSocket, QSslCipher, and QSslConfiguration.

## Member Type Documentation

### enum QSslDiffieHellmanParameters::Error

Describes a QSslDiffieHellmanParameters error.

Constant | Value | Description
--- | --- | ---
`QSslDiffieHellmanParameters::NoError` | `0` | No error occurred.
`QSslDiffieHellmanParameters::InvalidInputDataError` | `1` | The given input data could not be used to construct a QSslDiffieHellmanParameters object.
`QSslDiffieHellmanParameters::UnsafeParametersError` | `2` | The Diffie-Hellman parameters are unsafe and should not be used.

## Member Function Documentation

### QSslDiffieHellmanParameters::QSslDiffieHellmanParameters()

Constructs an empty QSslDiffieHellmanParameters instance.

If an empty QSslDiffieHellmanParameters instance is set on a QSslConfiguration object, Diffie-Hellman negotiation will be disabled.

See also isValid() and QSslConfiguration.

### QSslDiffieHellmanParameters::QSslDiffieHellmanParameters(const QSslDiffieHellmanParameters &other)

Constructs an identical copy of other.

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

Move-constructs from other.

Note: The moved-from object other is placed in a partially-formed state, in which the only valid operations are destruction and assignment of a new value.

### `[noexcept]` QSslDiffieHellmanParameters::~QSslDiffieHellmanParameters()

Destroys the QSslDiffieHellmanParameters object.

### `[static]` QSslDiffieHellmanParameters QSslDiffieHellmanParameters::defaultParameters()

Returns the default QSslDiffieHellmanParameters used by QSslSocket.

This is currently the 2048-bit MODP group from RFC 3526.

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

Returns the error that caused the QSslDiffieHellmanParameters object to be invalid.

### `[noexcept]` QString QSslDiffieHellmanParameters::errorString() const

Returns a human-readable description of the error that caused the QSslDiffieHellmanParameters object to be invalid.

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

Constructs a QSslDiffieHellmanParameters object using the byte array encoded in either PEM or DER form as specified by encoding.

Use the isValid() method on the returned object to check whether the Diffie-Hellman parameters were valid and loaded correctly.

See also isValid() and QSslConfiguration.

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

Constructs a QSslDiffieHellmanParameters object by reading from device in either PEM or DER form as specified by encoding.

Use the isValid() method on the returned object to check whether the Diffie-Hellman parameters were valid and loaded correctly.

In particular, if device is `nullptr` or not open for reading, an invalid object will be returned.

See also isValid() and QSslConfiguration.

### `[noexcept]` bool QSslDiffieHellmanParameters::isEmpty() const

Returns `true` if this is a an empty QSslDiffieHellmanParameters instance.

Setting an empty QSslDiffieHellmanParameters instance on a QSslSocket-based server will disable Diffie-Hellman key exchange.

### `[noexcept]` bool QSslDiffieHellmanParameters::isValid() const

Returns `true` if this is a valid QSslDiffieHellmanParameters; otherwise false.

This method should be used after constructing a QSslDiffieHellmanParameters object to determine its validity.

If a QSslDiffieHellmanParameters object is not valid, you can use the error() method to determine what error prevented the object from being constructed.

See also error().

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

Swaps this QSslDiffieHellmanParameters with other. This function is very fast and never fails.

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

Copies the contents of other into this QSslDiffieHellmanParameters, making the two QSslDiffieHellmanParameters identical.

Returns a reference to this QSslDiffieHellmanParameters.

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

Move-assigns other to this QSslDiffieHellmanParameters instance.

Note: The moved-from object other is placed in a partially-formed state, in which the only valid operations are destruction and assignment of a new value.

## Related Non-Members

### `[noexcept]` size_t qHash(const QSslDiffieHellmanParameters &dhparam, size_t seed = 0)

Returns an hash value for dhparam, using seed to seed the calculation.

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

Returns `true` if lhs is not equal to rhs; otherwise returns `false`.

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

Writes the set of Diffie-Hellman parameters in dhparam into the debug object debug for debugging purposes.

The Diffie-Hellman parameters will be represented in Base64-encoded DER form.

See also Debugging Techniques.

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

Returns `true` if lhs is equal to rhs; otherwise returns `false`.