すべてのプロダクト
Search
ドキュメントセンター

IoT Platform:共通エラーコード

最終更新日:Jun 04, 2026

C Link SDK がデバイス接続に失敗した際に返す共通のエラーコードをリストします。MQTT、HTTPS、ネットワークレイヤーのエラーを含みます。

接続に失敗した場合、Link SDK は内部ステータスを次の 2 つの方法で報告します。

  • API が 状態コード を返します。これは int32_t 型の非正整数です。0 は成功を示し、その他の値はランタイムステータスを示します。

    • retval = aiot_xxx_yyy() 形式で戻り値を取得します。

    • 各戻り値は、一意の内部実行ブランチに対応しています。詳細については、aiot_state_api.h または aiot_xxx_api.h をご参照ください。

    • すべてのコンポーネントの戻り値範囲は重複せず、0x0000 から 0xFFFF の範囲内に分散されています。

  • SDK がご利用のログコールバック関数を呼び出します。

以下の表に共通のエラーコードを示します。すべてのコードは aiot_state_api.h で定義されています。

MQTT アクセス

エラーコード

説明

STATE_MQTT_CONNACK_RCODE_SERVER_UNAVAILABLE

MQTT サーバーが接続を拒否しました。サービスを利用できません。しばらくしてから再試行してください。

STATE_MQTT_CONNACK_RCODE_BAD_USERNAME_PASSWORD

ユーザー名またはパスワードが無効です。

STATE_MQTT_CONNACK_RCODE_NOT_AUTHORIZED

MQTT サーバーの本人確認に失敗しました。パスワードが正しくありません。デバイスの認証情報を確認してください。

HTTPS アクセス

エラーコード

説明

STATE_HTTP_STATUS_LINE_INVALID

HTTPS 応答のステータスラインが無効です。StatusCode を取得できませんでした。

STATE_HTTP_READ_BODY_FINISHED

HTTPS メッセージ本文を完全に受信しましたが、これ以上のデータは利用できません。

STATE_HTTP_AUTH_CODE_FAILED

HTTPS 認証が 200 以外のステータスコードを返しました。認証署名を確認してください。

STATE_HTTP_AUTH_NOT_FINISHED

HTTPS 認証応答が不完全です。認証に失敗しました。

STATE_HTTP_AUTH_TOKEN_FAILED

HTTPS 認証応答からトークンを解析できませんでした。

ネットワークレイヤー

エラーコード

説明

STATE_PORT_NETWORK_DNS_FAILED

TCP DNS 解決に失敗しました。ドメイン名または IP アドレスを確認してください。

STATE_PORT_NETWORK_CONNECT_FAILED

TCP 接続の確立に失敗しました。

STATE_PORT_TLS_INVALID_MAX_FRAGMENT

TLS 最大メッセージ長が 0 に設定されています。これは無効です。値を再設定してください。

STATE_PORT_TLS_INVALID_SERVER_CERT

TLS サーバー証明書の構成が無効です。サーバー証明書を確認してください。

STATE_PORT_TLS_INVALID_CLIENT_CERT

TLS クライアント証明書の構成が無効です。クライアント証明書を確認してください。

STATE_PORT_TLS_INVALID_CLIENT_KEY

TLS クライアントキーの構成が無効です。クライアントキーを確認してください。

STATE_PORT_TLS_DNS_FAILED

TLS DNS 解決に失敗しました。ドメイン名または IP アドレスを確認してください。

STATE_PORT_TLS_SOCKET_CREATE_FAILED

TLS ソケットの作成に失敗しました。

STATE_PORT_TLS_SOCKET_CONNECT_FAILED

TLS ソケットへの接続に失敗しました。

STATE_PORT_TLS_INVALID_RECORD

無効な SSL パケットを受信しました。TLS フレームデータ長が短すぎないか確認してください。