En esta página

QSslKey Class

La clase QSslKey proporciona una interfaz para claves privadas y públicas. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

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

Descripción detallada

QSslKey proporciona una API sencilla para gestionar claves.

Véase también QSslSocket, QSslCertificate y QSslCipher.

Documentación de las funciones de miembro

QSslKey::QSslKey()

Crea una clave nula.

Véase también ` isNull()`.

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

Crea un objeto QSslKey a partir de una clave nativa válida handle. type especifica si la clave es pública o privada.

QSslKey asumirá la propiedad de esta clave y no debes liberarla utilizando la biblioteca nativa.

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

Crea un objeto `QSslKey` leyendo y decodificando los datos de un archivo ` device ` utilizando los formatos especificados ` algorithm ` y ` encoding `. El parámetro ` type ` especifica si la clave es pública o privada.

Si la clave está cifrada, se utiliza ` passPhrase ` para descifrarla.

Tras la creación, utiliza isNull() para comprobar si device ha proporcionado una clave válida.

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

Crea un objeto `QSslKey` descodificando la cadena contenida en la matriz de bytes ` encoded ` utilizando los formatos especificados ` algorithm ` y ` encoding `. ` type ` especifica si la clave es pública o privada.

Si la clave está cifrada, se utiliza passPhrase para descifrarla.

Tras la creación, utiliza isNull() para comprobar si encoded contiene una clave válida.

QSslKey::QSslKey(const QSslKey &other)

Crea una copia idéntica de other.

[noexcept] QSslKey::~QSslKey()

Elimina el objeto « QSslKey ».

QSsl::KeyAlgorithm QSslKey::algorithm() const

Devuelve el algoritmo de clave.

void QSslKey::clear()

Borra el contenido de esta clave, convirtiéndola en una clave nula.

Véase también isNull().

Qt::HANDLE QSslKey::handle() const

Devuelve un puntero al identificador nativo de la clave, si existe; en caso contrario, devuelve nullptr.

Puedes utilizar este identificador junto con la API nativa para acceder a información ampliada sobre la clave.

Advertencia: Es muy probable queel uso de esta función no sea portátil, y su valor de retorno puede variar entre plataformas y entre versiones menores de Qt.

bool QSslKey::isNull() const

Devuelve ` true ` si se trata de una clave nula; en caso contrario, devuelve `false`.

Véase también clear().

int QSslKey::length() const

Devuelve la longitud de la clave en bits, o -1 si la clave es nula.

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

Cambia esta clave SSL por other. Esta operación es muy rápida y nunca falla.

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

Devuelve la clave en codificación DER.

El argumento « passPhrase » debe omitirse, ya que el formato DER no se puede cifrar. Se eliminará en una futura versión de Qt.

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

Devuelve la clave en codificación PEM. El resultado se cifra mediante passPhrase si la clave es una clave privada y passPhrase no está vacío.

QSsl::KeyType QSslKey::type() const

Devuelve el tipo de la clave (es decir, PublicKey o PrivateKey).

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

Devuelve ` true ` si esta clave no es igual a `key other`; en caso contrario, devuelve ` false`.

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

Copia el contenido de other en esta clave, haciendo que ambas claves sean idénticas.

Devuelve una referencia a este « QSslKey ».

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

Devuelve « true » si esta clave es igual a « other »; en caso contrario, devuelve « 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.