QMqtt Namespace

Qt MQTT モジュール全体で使用される各種識別子が含まれています。詳細...

ヘッダー:	`#include <qmqttglobal.h>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Mqtt)` `target_link_libraries(mytarget PRIVATE Qt6::Mqtt)`
qmake:	`QT += mqtt`

種類

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

詳細な説明

型のドキュメント

enum class QMqtt::MessageStatus

この列挙型は、メッセージの可能な状態を指定します。クライアントのQoSや役割に応じて、期待されるメッセージの状態は異なります。

定数	値	説明
`QMqtt::MessageStatus::Unknown`	`0`	メッセージの状態が不明です。
`QMqtt::MessageStatus::Published`	`1`	クライアントは、自身のサブスクリプションのいずれかに対するメッセージを受信しました。これは、QoS レベル 1 および 2 に適用されます。
`QMqtt::MessageStatus::Acknowledged`	`2`	メッセージの受信確認が行われました。これは QoS 1 に適用され、クライアント側でのメッセージ処理が完了したことを示します。
`QMqtt::MessageStatus::Received`	`3`	メッセージを受信しました。これはQoSレベル2に適用されます。
`QMqtt::MessageStatus::Released`	`4`	メッセージが解放されました。これはQoS 2に適用されます。パブリッシャー側では、メッセージの処理が完了しました。
`QMqtt::MessageStatus::Completed`	`5`	メッセージが完了しました。これはQoS 2に適用され、クライアント側でのメッセージ処理が完了したことを示します。

enum class QMqtt::PayloadFormatIndicator

ペイロード形式は、メッセージの内容に関する情報を提供します。これにより、他のクライアントがメッセージをより迅速に処理できるようになります。

定数	値	説明
`QMqtt::PayloadFormatIndicator::Unspecified`	`0`	フォーマットは指定されていません。
`QMqtt::PayloadFormatIndicator::UTF8Encoded`	`1`	メッセージのペイロードは、UTF-8 エンコードされた文字データとしてフォーマットされます。

enum class QMqtt::ReasonCode

この列挙型は、利用可能なエラーコードを指定します。

定数	値	説明
`QMqtt::ReasonCode::Success`	`0`	指定されたアクションが成功しました。
`QMqtt::ReasonCode::SubscriptionQoSLevel0`	`0`	QoS レベル 0 のサブスクリプションが作成されました。
`QMqtt::ReasonCode::SubscriptionQoSLevel1`	`0x01`	QoS レベル 1 のサブスクリプションが作成されました。
`QMqtt::ReasonCode::SubscriptionQoSLevel2`	`0x02`	QoS レベル 2 のサブスクリプションが作成されました。
`QMqtt::ReasonCode::NoMatchingSubscriber`	`0x10`	メッセージはサーバーによって受け入れられましたが、このメッセージを受信するサブスクライバーがいません。ブローカーは、「Success」の代わりにこの理由コードを送信する場合があります。
`QMqtt::ReasonCode::NoSubscriptionExisted (since Qt 5.15)`	`0x11`	クライアントによって、一致するトピックフィルターが使用されていません。
`QMqtt::ReasonCode::ContinueAuthentication (since Qt 5.15)`	`0x18`	別のステップで認証を続行してください。
`QMqtt::ReasonCode::ReAuthenticate (since Qt 5.15)`	`0x19`	再認証を開始してください。
`QMqtt::ReasonCode::UnspecifiedError`	`0x80`	不特定のエラーが発生しました。
`QMqtt::ReasonCode::MalformedPacket`	`0x81`	サーバーに送信されたパケットが無効です。
`QMqtt::ReasonCode::ProtocolError`	`0x82`	プロトコルエラーが発生しました。ほとんどの場合、これによりサーバーはクライアントとの接続を切断します。
`QMqtt::ReasonCode::ImplementationSpecificError`	`0x83`	パケットは有効ですが、受信側がそれを拒否しました。
`QMqtt::ReasonCode::UnsupportedProtocolVersion`	`0x84`	要求されたプロトコルバージョンは、サーバーでサポートされていません。
`QMqtt::ReasonCode::InvalidClientId`	`0x85`	クライアント ID が無効です。
`QMqtt::ReasonCode::InvalidUserNameOrPassword`	`0x86`	指定されたユーザー名またはパスワードが無効です。
`QMqtt::ReasonCode::NotAuthorized`	`0x87`	クライアントは、指定された操作を行う権限がありません。
`QMqtt::ReasonCode::ServerNotAvailable`	`0x88`	接続先のサーバーが利用できません。
`QMqtt::ReasonCode::ServerBusy`	`0x89`	接続先のサーバーが利用できません。クライアントは、後ほど再度試すよう求められています。
`QMqtt::ReasonCode::ClientBanned`	`0x8A`	クライアントはサーバーからアクセス禁止となっています。
`QMqtt::ReasonCode::InvalidAuthenticationMethod`	`0x8C`	指定された認証方式が無効です。
`QMqtt::ReasonCode::InvalidTopicFilter`	`0x8F`	指定されたトピック・フィルターが無効です。
`QMqtt::ReasonCode::InvalidTopicName`	`0x90`	指定されたトピック名は無効です。
`QMqtt::ReasonCode::MessageIdInUse`	`0x91`	前のパケットで使用されたメッセージ ID は、すでに使用されています。
`QMqtt::ReasonCode::MessageIdNotFound`	`0x92`	前のパケットで使用されたメッセージ ID が見つかりませんでした。
`QMqtt::ReasonCode::PacketTooLarge`	`0x95`	受信したパケットが大きすぎます。QMqttServerConnectionProperties::maximumPacketSize() も参照してください。
`QMqtt::ReasonCode::QuotaExceeded`	`0x97`	管理上設定された制限を超えています。
`QMqtt::ReasonCode::InvalidPayloadFormat`	`0x99`	ペイロードの形式が無効です。QMqttPublishProperties::payloadFormatIndicator() も参照してください。
`QMqtt::ReasonCode::RetainNotSupported`	`0x9A`	サーバーはリテインされたメッセージをサポートしていません。QMqttServerConnectionProperties::retainAvailable() も参照してください。
`QMqtt::ReasonCode::QoSNotSupported`	`0x9B`	要求された QoS レベルはサポートされていません。QMqttServerConnectionProperties::maximumQoS() も参照してください。
`QMqtt::ReasonCode::UseAnotherServer`	`0x9C`	クライアントが接続しようとしているサーバーが利用できません。QMqttServerConnectionProperties::serverReference() も参照してください。
`QMqtt::ReasonCode::ServerMoved`	`0x9D`	クライアントが接続しようとしているサーバーが新しいアドレスに移動しました。QMqttServerConnectionProperties::serverReference() も参照してください。
`QMqtt::ReasonCode::SharedSubscriptionsNotSupported`	`0x9E`	共有サブスクリプションはサポートされていません。QMqttServerConnectionProperties::sharedSubscriptionSupported() も参照してください。
`QMqtt::ReasonCode::ExceededConnectionRate`	`0x9F`	接続レート制限を超過しました。
`QMqtt::ReasonCode::SubscriptionIdsNotSupported`	`0xA1`	サブスクリプション ID はサポートされていません。QMqttServerConnectionProperties::subscriptionIdentifierSupported() も参照してください。
`QMqtt::ReasonCode::WildCardSubscriptionsNotSupported`	`0xA2`	ワイルドカードを使用したサブスクリプションは、サーバーでサポートされていません。QMqttServerConnectionProperties::wildcardSupported() も参照してください。

すべてのユースケースで、すべての値が利用可能というわけではありません。特に、一部のサーバーでは、特定のコマンドに適さない理由コードを拒否する場合があります。特定のアクションで予想される理由コードについては、以下の表を参照してください。

理由コード	接続プロパティ	サブスクリプションのプロパティ	メッセージのプロパティ
成功	X	X	X
SubscriptionQoSLevel0		X
サブスクリプションQoSレベル1		X
サブスクリプションQoSレベル2		X
一致する加入者がいない			X
未指定のエラー	X	X	X
不正なパケット	X
プロトコルエラー	X
実装固有のエラー	X	X	X
UnsupportedProtocolVersion	X
無効なクライアントID	X
無効なユーザー名またはパスワード	X
権限なし	X	X	X
サーバー利用不可	X
サーバーがビジー状態	X
クライアントが利用禁止	X
認証方法が不正です	X
トピックフィルターが無効です		X
トピック名が不正です	X		X
使用中のメッセージID		X	X
MessageIdNotFound			X
PacketTooLarge	X
割り当て超過	X	X	X
ペイロード形式が無効	X		X
保持はサポートされていません	X
QoS未対応	X
別のサーバーを使用する	X
サーバーが移動しました	X
共有サブスクリプションはサポートされていません		X
接続レート超過	X
サブスクリプションIDがサポートされていません		X
ワイルドカードサブスクリプションはサポートされていません		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.