En esta página

QMqtt Namespace

Contiene identificadores diversos que se utilizan a lo largo del módulo « Qt MQTT ». Más información...

Cabecera: #include <qmqttglobal.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Mqtt)
target_link_libraries(mytarget PRIVATE Qt6::Mqtt)
qmake: QT += mqtt

Tipos

enum class MessageStatus { Unknown, Published, Acknowledged, Received, Released, Completed }
enum class PayloadFormatIndicator { Unspecified, UTF8Encoded }
enum class ReasonCode { Success, SubscriptionQoSLevel0, SubscriptionQoSLevel1, SubscriptionQoSLevel2, NoMatchingSubscriber, …, WildCardSubscriptionsNotSupported }

Descripción detallada

Documentación sobre tipos

enum class QMqtt::MessageStatus

Este tipo de enumeración especifica los estados disponibles de un mensaje. En función de la calidad de servicio (QoS) y de la función del cliente, se esperan diferentes estados del mensaje.

ConstanteValorDescripción
QMqtt::MessageStatus::Unknown0Se desconoce el estado del mensaje.
QMqtt::MessageStatus::Published1El cliente ha recibido un mensaje para una de sus suscripciones. Esto se aplica a los niveles de QoS 1 y 2.
QMqtt::MessageStatus::Acknowledged2Se ha confirmado la recepción de un mensaje. Esto se aplica al nivel de QoS 1 e indica que el cliente ha finalizado el procesamiento del mensaje.
QMqtt::MessageStatus::Received3Se ha recibido un mensaje. Esto se aplica al nivel de calidad de servicio (QoS) 2.
QMqtt::MessageStatus::Released4Se ha liberado un mensaje. Esto se aplica al nivel de calidad de servicio (QoS) 2. Para un editor, se ha completado el procesamiento del mensaje.
QMqtt::MessageStatus::Completed5Se ha completado un mensaje. Esto se aplica al nivel de calidad de servicio (QoS) 2 e indica que el procesamiento del mensaje ha finalizado por parte del cliente.

enum class QMqtt::PayloadFormatIndicator

El formato de la carga útil proporciona información sobre el contenido de un mensaje. Esto puede ayudar a otros clientes a procesar el mensaje más rápidamente.

ConstanteValorDescripción
QMqtt::PayloadFormatIndicator::Unspecified0El formato no está especificado.
QMqtt::PayloadFormatIndicator::UTF8Encoded1La carga útil del mensaje tiene el formato «Datos de caracteres codificados en UTF-8».

enum class QMqtt::ReasonCode

Este tipo de enumeración especifica los códigos de error disponibles.

ConstanteValorDescripción
QMqtt::ReasonCode::Success0La acción especificada se ha realizado correctamente.
QMqtt::ReasonCode::SubscriptionQoSLevel00Se ha creado una suscripción con nivel de QoS 0.
QMqtt::ReasonCode::SubscriptionQoSLevel10x01Se ha creado una suscripción con nivel de QoS 1.
QMqtt::ReasonCode::SubscriptionQoSLevel20x02Se ha creado una suscripción con nivel de QoS 2.
QMqtt::ReasonCode::NoMatchingSubscriber0x10El servidor ha aceptado el mensaje, pero no hay suscriptores que lo reciban. Un bróker puede enviar este código de motivo en lugar de «Éxito».
QMqtt::ReasonCode::NoSubscriptionExisted (since Qt 5.15)0x11El cliente no está utilizando ningún filtro de temas que coincida.
QMqtt::ReasonCode::ContinueAuthentication (since Qt 5.15)0x18Continúa con la autenticación con otro paso.
QMqtt::ReasonCode::ReAuthenticate (since Qt 5.15)0x19Inicia una nueva autenticación.
QMqtt::ReasonCode::UnspecifiedError0x80Se ha producido un error no especificado.
QMqtt::ReasonCode::MalformedPacket0x81El paquete enviado al servidor no es válido.
QMqtt::ReasonCode::ProtocolError0x82Se ha producido un error de protocolo. En la mayoría de los casos, esto provocará que el servidor desconecte al cliente.
QMqtt::ReasonCode::ImplementationSpecificError0x83El paquete es válido, pero el destinatario lo rechaza.
QMqtt::ReasonCode::UnsupportedProtocolVersion0x84El servidor no admite la versión del protocolo solicitada.
QMqtt::ReasonCode::InvalidClientId0x85El ID de cliente no es válido.
QMqtt::ReasonCode::InvalidUserNameOrPassword0x86El nombre de usuario o la contraseña especificados no son válidos.
QMqtt::ReasonCode::NotAuthorized0x87El cliente no está autorizado para realizar la acción especificada.
QMqtt::ReasonCode::ServerNotAvailable0x88El servidor al que se debe conectar no está disponible.
QMqtt::ReasonCode::ServerBusy0x89El servidor al que se debe conectar no está disponible. Se pide al cliente que lo intente más tarde.
QMqtt::ReasonCode::ClientBanned0x8AEl cliente ha sido bloqueado en el servidor.
QMqtt::ReasonCode::InvalidAuthenticationMethod0x8CEl método de autenticación especificado no es válido.
QMqtt::ReasonCode::InvalidTopicFilter0x8FEl filtro de temas especificado no es válido.
QMqtt::ReasonCode::InvalidTopicName0x90El nombre del tema especificado no es válido.
QMqtt::ReasonCode::MessageIdInUse0x91El ID del mensaje utilizado en el paquete anterior ya está en uso.
QMqtt::ReasonCode::MessageIdNotFound0x92No se ha encontrado el ID de mensaje utilizado en el paquete anterior.
QMqtt::ReasonCode::PacketTooLarge0x95El paquete recibido es demasiado grande. Véase también QMqttServerConnectionProperties::maximumPacketSize().
QMqtt::ReasonCode::QuotaExceeded0x97Se ha superado un límite impuesto administrativamente.
QMqtt::ReasonCode::InvalidPayloadFormat0x99El formato de la carga útil no es válido. Véase también QMqttPublishProperties::payloadFormatIndicator().
QMqtt::ReasonCode::RetainNotSupported0x9AEl servidor no admite mensajes retenidos. Véase también QMqttServerConnectionProperties::retainAvailable().
QMqtt::ReasonCode::QoSNotSupported0x9BNo se admite el nivel de QoS solicitado. Véase también QMqttServerConnectionProperties::maximumQoS().
QMqtt::ReasonCode::UseAnotherServer0x9CEl servidor al que el cliente intenta conectarse no está disponible. Véase también QMqttServerConnectionProperties::serverReference().
QMqtt::ReasonCode::ServerMoved0x9DEl servidor al que el cliente intenta conectarse se ha trasladado a una nueva dirección. Véase también QMqttServerConnectionProperties::serverReference().
QMqtt::ReasonCode::SharedSubscriptionsNotSupported0x9ENo se admiten suscripciones compartidas. Véase también QMqttServerConnectionProperties::sharedSubscriptionSupported().
QMqtt::ReasonCode::ExceededConnectionRate0x9FSe ha superado el límite de velocidad de conexión.
QMqtt::ReasonCode::SubscriptionIdsNotSupported0xA1No se admiten los ID de suscripción. Véase también QMqttServerConnectionProperties::subscriptionIdentifierSupported().
QMqtt::ReasonCode::WildCardSubscriptionsNotSupported0xA2El servidor no admite suscripciones que utilicen comodines. Véase también QMqttServerConnectionProperties::wildcardSupported().

No todos los valores están disponibles en todos los casos de uso. En particular, algunos servidores rechazarán un código de motivo que no sea adecuado para un comando específico. Consulte la tabla siguiente para conocer los códigos de motivo esperados para acciones específicas.

Código de motivoPropiedades de conexiónPropiedades de la suscripciónPropiedades del mensaje
ÉxitoXXX
SubscriptionQoSLevel0X
Nivel de calidad de servicio de suscripción 1X
Nivel de calidad de servicio de suscripción 2X
No hay suscriptor coincidenteX
Error no especificadoXXX
Paquete mal formadoX
Error de protocoloX
Error específico de la implementaciónXXX
Versión de protocolo no compatibleX
Identificador de cliente no válidoX
Nombre de usuario o contraseña no válidosX
No autorizadoXXX
Servidor no disponibleX
Servidor ocupadoX
Cliente bloqueadoX
Método de autenticación no válidoX
Filtro de tema no válidoX
Nombre de tema no válidoXX
Identificador de mensaje en usoXX
MessageIdNotFoundX
Paquete demasiado grandeX
Se ha superado el límiteXXX
Formato de carga útil no válidoXX
No se admite la retenciónX
QoS no compatibleX
UsarOtroServidorX
ServidorTrasladadoX
No se admiten suscripciones compartidasX
Se ha superado la tasa de conexiónX
No se admiten ID de suscripciónX
Suscripciones con comodines no admitidasX

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