QMqtt Namespace

Contiene varios identificadores utilizados en el módulo Qt MQTT. Más...

Cabecera:	`#include <QMqtt>`
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 de tipos

enum class QMqtt::MessageStatus

Este tipo enum especifica los estados disponibles de un mensaje. Dependiendo de la QoS y del rol del cliente, se esperan diferentes estados de mensaje.

Constante	Valor	Descripción
`QMqtt::MessageStatus::Unknown`	`0`	El estado del mensaje es desconocido.
`QMqtt::MessageStatus::Published`	`1`	El cliente ha recibido un mensaje para una de sus suscripciones. Esto se aplica a los niveles de calidad de servicio 1 y 2.
`QMqtt::MessageStatus::Acknowledged`	`2`	Se ha acusado recibo de un mensaje. Esto se aplica a QoS 1 e indica que la gestión del mensaje ha finalizado por parte del cliente.
`QMqtt::MessageStatus::Received`	`3`	Se ha recibido un mensaje. Se aplica a QoS 2.
`QMqtt::MessageStatus::Released`	`4`	Se ha liberado un mensaje. Se aplica a QoS 2. Para un editor, la gestión de mensajes ha finalizado.
`QMqtt::MessageStatus::Completed`	`5`	Se ha completado un mensaje. Esto se aplica a la QoS 2 e indica que la gestión de mensajes ha finalizado desde el lado 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 manejar el mensaje más rápidamente.

Constante	Valor	Descripción
`QMqtt::PayloadFormatIndicator::Unspecified`	`0`	No se especifica el formato.
`QMqtt::PayloadFormatIndicator::UTF8Encoded`	`1`	La carga útil del mensaje está formateada como Datos de caracteres codificados UTF-8.

enum class QMqtt::ReasonCode

Este tipo enum especifica los códigos de error disponibles.

Constante	Valor	Descripción
`QMqtt::ReasonCode::Success`	`0`	La acción especificada se ha realizado correctamente.
`QMqtt::ReasonCode::SubscriptionQoSLevel0`	`0`	Se ha creado una suscripción con nivel 0 de QoS.
`QMqtt::ReasonCode::SubscriptionQoSLevel1`	`0x01`	Se ha creado una suscripción con nivel 1 de QoS.
`QMqtt::ReasonCode::SubscriptionQoSLevel2`	`0x02`	Se ha creado una suscripción con nivel 2 de QoS.
`QMqtt::ReasonCode::NoMatchingSubscriber`	`0x10`	El mensaje ha sido aceptado por el servidor, pero no hay suscriptores para recibir este mensaje. Un agente puede enviar este código de motivo en lugar de Éxito.
`QMqtt::ReasonCode::NoSubscriptionExisted (since Qt 5.15)`	`0x11`	El cliente no está utilizando ningún filtro de temas coincidente.
`QMqtt::ReasonCode::ContinueAuthentication (since Qt 5.15)`	`0x18`	Continúe la autenticación con otro paso.
`QMqtt::ReasonCode::ReAuthenticate (since Qt 5.15)`	`0x19`	Inicie una nueva autenticación.
`QMqtt::ReasonCode::UnspecifiedError`	`0x80`	Se ha producido un error no especificado.
`QMqtt::ReasonCode::MalformedPacket`	`0x81`	El paquete enviado al servidor no es válido.
`QMqtt::ReasonCode::ProtocolError`	`0x82`	Se ha producido un error de protocolo. En la mayoría de los casos, esto hará que el servidor desconecte al cliente.
`QMqtt::ReasonCode::ImplementationSpecificError`	`0x83`	El paquete es válido, pero el destinatario lo rechaza.
`QMqtt::ReasonCode::UnsupportedProtocolVersion`	`0x84`	La versión de protocolo solicitada no es compatible con el servidor.
`QMqtt::ReasonCode::InvalidClientId`	`0x85`	El ID del cliente no es válido.
`QMqtt::ReasonCode::InvalidUserNameOrPassword`	`0x86`	El nombre de usuario o la contraseña especificados no son válidos.
`QMqtt::ReasonCode::NotAuthorized`	`0x87`	El cliente no está autorizado para la acción especificada.
`QMqtt::ReasonCode::ServerNotAvailable`	`0x88`	El servidor al que conectarse no está disponible.
`QMqtt::ReasonCode::ServerBusy`	`0x89`	El servidor al que debe conectarse no está disponible. Se pide al cliente que lo intente más tarde.
`QMqtt::ReasonCode::ClientBanned`	`0x8A`	El cliente ha sido excluido del servidor.
`QMqtt::ReasonCode::InvalidAuthenticationMethod`	`0x8C`	El método de autenticación especificado no es válido.
`QMqtt::ReasonCode::InvalidTopicFilter`	`0x8F`	El filtro de temas especificado no es válido.
`QMqtt::ReasonCode::InvalidTopicName`	`0x90`	El nombre del tema especificado no es válido.
`QMqtt::ReasonCode::MessageIdInUse`	`0x91`	El ID de mensaje utilizado en el paquete anterior ya está en uso.
`QMqtt::ReasonCode::MessageIdNotFound`	`0x92`	No se ha encontrado el ID de mensaje utilizado en el paquete anterior.
`QMqtt::ReasonCode::PacketTooLarge`	`0x95`	El paquete recibido es demasiado grande. Véase también QMqttServerConnectionProperties::maximumPacketSize().
`QMqtt::ReasonCode::QuotaExceeded`	`0x97`	Se ha superado un límite impuesto administrativamente.
`QMqtt::ReasonCode::InvalidPayloadFormat`	`0x99`	El formato de la carga útil no es válido. Véase también QMqttPublishProperties::payloadFormatIndicator().
`QMqtt::ReasonCode::RetainNotSupported`	`0x9A`	El servidor no admite mensajes retenidos. Véase también QMqttServerConnectionProperties::retainAvailable().
`QMqtt::ReasonCode::QoSNotSupported`	`0x9B`	No se admite el nivel de QoS solicitado. Véase también QMqttServerConnectionProperties::maximumQoS().
`QMqtt::ReasonCode::UseAnotherServer`	`0x9C`	El servidor al que intenta conectarse el cliente no está disponible. Véase también QMqttServerConnectionProperties::serverReference().
`QMqtt::ReasonCode::ServerMoved`	`0x9D`	El servidor al que intenta conectarse el cliente ha cambiado de dirección. Véase también QMqttServerConnectionProperties::serverReference().
`QMqtt::ReasonCode::SharedSubscriptionsNotSupported`	`0x9E`	No se admiten las suscripciones compartidas. Véase también QMqttServerConnectionProperties::sharedSubscriptionSupported().
`QMqtt::ReasonCode::ExceededConnectionRate`	`0x9F`	Se ha superado el límite de velocidad de conexión.
`QMqtt::ReasonCode::SubscriptionIdsNotSupported`	`0xA1`	No se admiten ID de suscripción. Véase también QMqttServerConnectionProperties::subscriptionIdentifierSupported().
`QMqtt::ReasonCode::WildCardSubscriptionsNotSupported`	`0xA2`	El servidor no admite suscripciones con comodines. Véase también QMqttServerConnectionProperties::wildcardSupported().

No todos los valores están disponibles en todos los casos de uso. Especialmente, algunos servidores rechazarán un código de razón no 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 motivo	Propiedades de conexión	Propiedades de suscripción	Propiedades del mensaje
Éxito	X	X	X
SuscripciónQoNivel0		X
SuscripciónQoSLevel1		X
SuscripciónQoSLevel2		X
NoMatchingSubscriber			X
UnspecifiedError	X	X	X
MalformedPacket	X
ErrorProtocolo	X
ImplementationSpecificError	X	X	X
UnsupportedProtocolVersion	X
InvalidClientId	X
InvalidUserNameOrPassword	X
NoAutorizado	X	X	X
Servidor no disponible	X
Servidor ocupado	X
Cliente bloqueado	X
InvalidAuthenticationMethod	X
InvalidTopicFilter		X
InvalidTopicName	X		X
MessageIdInUse		X	X
MessageIdNotFound			X
PacketTooLarge	X
QuotaExceeded	X	X	X
InvalidPayloadFormat	X		X
RetainNotSupported	X
QoSNotSupported	X
UseAnotherServer	X
ServidorMovido	X
SharedSubscriptionsNotSupported		X
ExceededConnectionRate	X
SubscriptionIdsNotSupported		X
WildCardSubscriptionsNotSupported		X

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