En esta página

QSslKey Class

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

Cabecera: #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 la gestión de claves.

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

Documentación de las funciones miembro

QSslKey::QSslKey()

Construye una clave nula.

Véase también isNull().

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

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

QSslKey tomará la propiedad de esta clave y no debes liberar la clave usando la librería nativa.

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

Construye una QSslKey leyendo y descodificando datos de un device utilizando un formato especificado algorithm y encoding. type especifica si la clave es pública o privada.

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

Después de la construcción, utilice isNull() para comprobar si device proporcionó 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())

Construye una QSslKey decodificando la cadena en la matriz de bytes encoded utilizando un formato especificado 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 construcción, utilice isNull() para comprobar si encoded contiene una clave válida.

QSslKey::QSslKey(const QSslKey &other)

Construye una copia idéntica de other.

[noexcept] QSslKey::~QSslKey()

Destruye el objeto QSslKey.

QSsl::KeyAlgorithm QSslKey::algorithm() const

Devuelve el algoritmo de la 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 manejador nativo de la clave, si existe, en caso contrario nullptr.

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

Advertencia: El uso de esta función tiene una alta probabilidad de no ser portable, 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, 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)

Intercambia esta clave ssl con 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 DER no puede cifrarse. 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 con passPhrase si la clave es una clave privada y passPhrase no está vacío.

QSsl::KeyType QSslKey::type() const

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

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

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

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

Copia el contenido de other en esta clave, haciendo que las dos 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.