WifiConfig_NetworkDiagnostics指示

頁首： #include < applibs/wificonfig.h>

有關最近連線到網路失敗的資訊。

注意

這是版本結構的別名。 定義WIFICONFIG_STRUCTS_VERSION使用此別名。

typedef struct WifiConfig_NetworkDiagnostics {

    uint8_t isEnabled;
    uint8_t isConnected;
    int32_t error;
    time_t timestamp;
    int32_t certError;
    int32_t certDepth;
    CertStore_SubjectName certSubject;
} WifiConfig_NetworkDiagnostics;

成員

uint8_t IsEnabled

表示網路是否已啟用。 啟用時的值為 1，若未啟用則為 0。 此欄位會指出網路的目前狀態，而不是設定的狀態。 如果暫時停用網路，值會是 0。

uint8_t已連接

指出網路是否已連線。 如果已連線，值為 1，若未連線則為 0。

int32_t錯誤

最近無法連線到此網路的原因。 可能的值：

類型	價值	意義
ConnectionFailed	1	連線失敗時出現一般錯誤訊息。 對於 EAP-TLS 網路，此錯誤可能是因為無法連線到 RADIUS 伺服器或使用 RADIUS 伺服器無法辨識的用戶端身分識別所導致。
NetworkNotFound	2	找不到網路。
NoPskIncluded	3	網路密碼遺失。
WrongKey	4	網路使用不正確的密碼。
AuthenticationFailed	5	驗證失敗。 此錯誤僅適用于 EAP-TLS 網路。
SecurityTypeMismatch	6	儲存的網路安全性類型與可用的網路不符。
NetworkFrequencyNotAllowed	7	不允許網路頻率。
NetworkNotEssPbssMbss	8	系統未偵測到 ESS) 、個人基本服務集 ( (PBSS) 或最低比較基準安全性標準 (MBSS) ，因此不支援網路。
NetworkNotSupported	9	不支援網路。
NetworkNonWpa	10	網路不是 WPA2PSK、WPA2EAP 或 Open。

time_t時間戳記

記錄錯誤的作業系統時間。

int32_t認證

憑證錯誤，僅在指出 AuthenticationFailed 時 error 才有意義。 注意：在某些情況下 certError ，可能無法傳回錯誤。

可能的值：

   ERRID                          Potential Problem
   Unspecified = 0:               Generic error message when certificate validation fails.
   Certificate Not Found = 100:   This could be due to an incorrect certificate specified when configuring the EAP-TLS network, or ReloadConfig() was not called after loading   the certificates onto the device.
   Invalid Root CA= 101:          Root CA incorrect due to expiry, invalid chain, or other issues verifying the server certificate.
   Invalid client authentication  Invalid client certificate or using a valid client identity but incorrectly associated with client certificate.
   =102:

類型	價值	意義
ConnectionFailed	0	憑證驗證失敗時出現一般錯誤訊息。
找不到憑證	100	設定 EAP-TLS 網路時指定的憑證不正確，或 ReloadConfig() 在將憑證載入裝置後未撥打。
不正確根 CA	101	根 CA 不正確，因為到期、鏈結無效，或其他驗證服務器憑證的問題。
不正確用戶端驗證	102	1) 伺服器無法辨識或包含錯誤的用戶端憑證，或是 2) 與用戶端憑證不正確關聯的有效用戶端身分識別 (例如，另一個使用者密碼) 的已知使用者名稱。
未知的用戶端識別碼	103	驗證服務器無法辨識用戶端身分識別。

int32_t認證

憑證在認證鏈中的位置。 只有在表示 AuthenticationFailed 且 certDepth 非負數 (0 或正數) 數位時 error 才具有意義。

CertStore_SubjectName認證專案

憑證的主旨。 僅在表示 AuthenticationFailed 時 error 才具有意義。