適用於 Eclipse ThreadX API 的 Defender-IoT-micro-agent （預覽）
適用於IoT的Defender API受 Microsoft API 授權和使用規定所控管。
此 API 僅適用於適用於 Eclipse ThreadX 的 Defender-IoT-micro-agent。 如需其他資源，請參閱 適用於 Eclipse ThreadX GitHub 資源的 Defender-IoT-micro-agent。
注意
適用於 IoT 的 Defender 計劃於 2025 年 8 月 1 日淘汰微代理程式。
啟用適用於 Eclipse ThreadX 的 Defender-IoT-micro-agent
nx_azure_iot_security_module_enable
原型
UINT nx_azure_iot_security_module_enable(NX_AZURE_IOT *nx_azure_iot_ptr);
描述
此例程可啟用 Azure IoT Defender-IoT-micro-agent 子系統。 內部狀態機器會管理安全性事件的集合，並將其傳送至 Azure IoT 中樞。 只需要一個NX_AZURE_IOT_SECURITY_MODULE實例，而且需要管理數據收集。
參數
| 名稱 | 描述 |
|---|---|
| nx_azure_iot_ptr [in] | 的 NX_AZURE_IOT指標。 |
傳回值
| 傳回值 | 描述 |
|---|---|
| NX_AZURE_IOT_SUCCESS | 已成功啟用 Azure IoT 安全性模組。 |
| NX_AZURE_IOT_FAILURE | 無法啟用 Azure IoT 安全性模組，因為發生內部錯誤。 |
| NX_AZURE_IOT_INVALID_PARAMETER | 安全性模組需要有效的 #NX_AZURE_IOT 實例。 |
允許從
執行緒
停用 Azure IoT Defender-IoT-micro-agent
nx_azure_iot_security_module_disable
原型
UINT nx_azure_iot_security_module_disable(NX_AZURE_IOT *nx_azure_iot_ptr);
描述
此例程會停用 Azure IoT Defender-IoT-micro-agent 子系統。
參數
| 名稱 | 描述 |
|---|---|
| nx_azure_iot_ptr [in] | 的 NX_AZURE_IOT指標。 如果 NULL，則會停用單一實例。 |
傳回值
| 傳回值 | 描述 |
|---|---|
| NX_AZURE_IOT_SUCCESS | 成功停用 Azure IoT 安全性模組時。 |
| NX_AZURE_IOT_INVALID_PARAMETER | Azure IoT 中樞 實例與單一復合實例不同。 |
| NX_AZURE_IOT_FAILURE | 由於內部錯誤，無法停用 Azure IoT 安全性模組。 |
允許從
執行緒
下一步
若要深入瞭解如何開始使用 Eclipse ThreadX Defender-IoT-micro-agent，請參閱下列文章：
- 檢閱適用於IoT的Defender ThreadX Defender-IoT-micro-agent 概觀。