En esta página

QMqttConnectionProperties Class

La clase `QMqttConnectionProperties` representa las opciones de configuración que un ` QMqttClient ` puede pasar al servidor al invocar ` QMqttClient::connectToHost()`. Más información...

Encabezado: #include <QMqttConnectionProperties>
CMake: find_package(Qt6 REQUIRED COMPONENTS Mqtt)
target_link_libraries(mytarget PRIVATE Qt6::Mqtt)
qmake: QT += mqtt
Heredado por:

QMqttServerConnectionProperties

Funciones públicas

QByteArray authenticationData() const
QString authenticationMethod() const
quint32 maximumPacketSize() const
quint16 maximumReceive() const
quint16 maximumTopicAlias() const
bool requestProblemInformation() const
bool requestResponseInformation() const
quint32 sessionExpiryInterval() const
void setAuthenticationData(const QByteArray &authData)
void setAuthenticationMethod(const QString &authMethod)
void setMaximumPacketSize(quint32 packetSize)
void setMaximumReceive(quint16 maximumReceive)
void setMaximumTopicAlias(quint16 alias)
void setRequestProblemInformation(bool problem)
void setRequestResponseInformation(bool response)
void setSessionExpiryInterval(quint32 expiry)
void setUserProperties(const QMqttUserProperties &properties)
QMqttUserProperties userProperties() const

Descripción detallada

Nota: Las propiedadesde conexión forman parte de la especificación MQTT 5.0 y no se pueden utilizar al conectarse con un nivel de protocolo inferior. Consulta QMqttClient::ProtocolVersion para obtener más información.

Documentación de las funciones de miembro

QByteArray QMqttConnectionProperties::authenticationData() const

Devuelve los datos de autenticación.

Véase también setAuthenticationData().

QString QMqttConnectionProperties::authenticationMethod() const

Devuelve el método de autenticación.

Véase también setAuthenticationMethod().

quint32 QMqttConnectionProperties::maximumPacketSize() const

Devuelve el tamaño máximo de paquete que el cliente puede recibir.

Véase también setMaximumPacketSize().

quint16 QMqttConnectionProperties::maximumReceive() const

Devuelve el número máximo de publicaciones de QoS 1 y QoS 2 que el cliente (cuando se obtiene de QMqttClient::connectionProperties()) o el servidor (cuando se obtiene de QMqttClient::serverConnectionProperties()) está dispuesto a procesar simultáneamente para esta sesión.

Véase también setMaximumReceive().

quint16 QMqttConnectionProperties::maximumTopicAlias() const

Devuelve el ID máximo de alias de tema que puede utilizar el cliente.

Véase también setMaximumTopicAlias().

bool QMqttConnectionProperties::requestProblemInformation() const

Indica si el cliente debe recibir información sobre los problemas.

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

bool QMqttConnectionProperties::requestResponseInformation() const

Indica si el cliente debe recibir información de respuesta.

Véase también setRequestResponseInformation().

quint32 QMqttConnectionProperties::sessionExpiryInterval() const

Devuelve el intervalo de caducidad de la sesión.

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

void QMqttConnectionProperties::setAuthenticationData(const QByteArray &authData)

Establece los datos de autenticación en authData.

Los datos de autenticación solo se pueden utilizar si se ha especificado un método de autenticación.

Véase también authenticationData() y authenticationMethod().

void QMqttConnectionProperties::setAuthenticationMethod(const QString &authMethod)

Establece el método de autenticación en « authMethod ».

Véase también authenticationMethod() y authenticationData().

void QMqttConnectionProperties::setMaximumPacketSize(quint32 packetSize)

Establece el tamaño máximo de paquete en packetSize. El tamaño máximo de paquete especifica el tamaño máximo que puede tener un paquete. Esto incluye la cabecera del paquete y sus propiedades.

Si no se especifica ningún tamaño máximo de paquete, no se impone ningún límite más allá de las restricciones del propio protocolo.

Véase también maximumPacketSize().

void QMqttConnectionProperties::setMaximumReceive(quint16 maximumReceive)

Establece el número máximo de publicaciones de QoS 1 y QoS 2 que el cliente está dispuesto a procesar simultáneamente para esta sesión en maximumReceive.

No se permite un valor máximo de recepción igual a 0.

Véase también maximumReceive().

void QMqttConnectionProperties::setMaximumTopicAlias(quint16 alias)

Establece el alias de tema máximo en alias. El alias de tema máximo especifica el valor más alto que el cliente aceptará del servidor. El cliente utiliza este valor para limitar el número de alias de tema que está dispuesto a mantener para la conexión.

El valor por defecto es 0. El valor 0 indica que el cliente no acepta ningún alias de tema en esta conexión.

Véase también maximumTopicAlias().

void QMqttConnectionProperties::setRequestProblemInformation(bool problem)

Establece la información sobre problemas de la solicitud en « problem ». El cliente utiliza esta opción para solicitar al servidor que devuelva información adicional en caso de error. Entre los tipos de error se incluyen los relacionados con la gestión de conexiones y mensajes por parte del servidor.

El valor por defecto es false, lo que indica que el cliente no debe recibir información sobre problemas que no esté relacionada con la gestión de la conexión. El servidor puede seguir enviando información sobre problemas relacionados con la gestión de la conexión. Si el valor es true, el servidor puede devolver información sobre problemas.

La información sobre problemas está disponible en las propiedades de usuario o en las cadenas de motivo de las clases de propiedades.

Véase también requestProblemInformation().

void QMqttConnectionProperties::setRequestResponseInformation(bool response)

Establece la información de respuesta a la solicitud en « response ». El cliente utiliza este valor para solicitar al servidor que devuelva información de respuesta una vez que se haya gestionado la solicitud de conexión.

El valor por defecto es false, lo que indica que el cliente no debe devolver ninguna información de respuesta. Si el valor es true, el servidor puede devolver información de respuesta, pero no está obligado a hacerlo.

Véase también requestResponseInformation().

void QMqttConnectionProperties::setSessionExpiryInterval(quint32 expiry)

Establece el intervalo de caducidad de la sesión en expiry. El intervalo de caducidad de la sesión especifica el número de segundos durante los que un servidor conserva la información sobre el estado del cliente tras el cierre de una conexión.

El valor por defecto es 0, lo que indica que la sesión se cierra cuando finaliza la conexión de red. Si el valor especificado es igual o superior a quint32, la sesión no caduca.

Véase también sessionExpiryInterval().

void QMqttConnectionProperties::setUserProperties(const QMqttUserProperties &properties)

Establece las propiedades de usuario de la conexión a properties.

El valor por defecto es no enviar ninguna información de usuario.

Véase también userProperties().

QMqttUserProperties QMqttConnectionProperties::userProperties() const

Devuelve las propiedades de usuario de la conexión.

Véase también setUserProperties().

© 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.