本頁面由 Cloud Translation API 翻譯而成。

nl::編織：:設定檔::軟體更新

這個命名空間包含 Weave 中的 Weave 軟體更新設定檔中的所有介面，其中包括對應的名稱相同的通訊協定。

總結

列舉
`@309{ kMsgType_ImageAnnounce = 0, kMsgType_ImageQuery = 1, kMsgType_ImageQueryResponse = 2, kMsgType_DownloadNotify = 3, kMsgType_NotifyResponse = 4, kMsgType_UpdateNotify = 5, kMsgType_ImageQueryStatus = 6 }`	列舉 SoftwareUpdate 訊息類型。
`@310{ kStatus_NoUpdateAvailable = 0x0001, kStatus_UpdateFailed = 0x0010, kStatus_InvalidInstructions = 0x0050, kStatus_DownloadFailed = 0x0051, kStatus_IntegrityCheckFailed = 0x0052, kStatus_Abort = 0x0053, kStatus_Retry = 0x0091 }`	列舉
`@311{ kFlag_PackageSpecPresent = 1, kFlag_LocaleSpecPresent = 2, kFlag_TargetNodeIdPresent = 4 }`	列舉 ImageQuery 頁框控制項欄位的控制標記。
`@312`	列舉 ImageQueryResponse 的選擇性更新選項欄位的位元遮罩。
`@313`	列舉 ImageQueryResponse 的選用更新選項欄位位移。
`@314{ kIntegrityType_SHA160 = 0, kIntegrityType_SHA256 = 1, kIntegrityType_SHA512 = 2, kIntegrityType_Last = 3 }`	列舉
`@315`	列舉完整性規格位元組字串的長度 (以位元組為單位)。
`@316{ kUpdateScheme_HTTP = 0, kUpdateScheme_HTTPS = 1, kUpdateScheme_SFTP = 2, kUpdateScheme_BDX = 3, kUpdateScheme_Last = 4 }`	列舉
`@317`	列舉 SoftwareUpdate 設定檔的資料元素標記。
`UpdateCondition{ IfUnmatched, IfLater, Unconditionally, OnOptIn }`	列舉更新政策所規範的條件。
`UpdatePriority{ Normal, Critical }`	列舉更新優先順序。

函式
`integrityLength(uint8_t aType)`	`int` 支援將 IntegrityTypes 值對應至該類型雜湊長度的方法。

類別
nl::Weave::Profiles::SoftwareUpdate::IWeaveImageAnnounceServerDelegate	WeaveImageAnnounceServer 委派介面的介面。
nl::Weave::Profiles::SoftwareUpdate::ImageAnununce	說明 ImageAnnounce 訊息的類別。
nl::Weave::Profiles::SoftwareUpdate::ImageQuery	支援建立和解碼圖片查詢訊息的類別。
nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse	支援建立和解碼圖片查詢回應訊息的類別。
nl::Weave::Profiles::SoftwareUpdate:: IntegritySpec	包含軟體更新圖片完整性類型和軟體雜湊的輔助類別。
nl::Weave::Profiles::SoftwareUpdate::IntegrityTypeList	包含完整性類別清單的補充類別，做為圖片查詢的一部分。
nl::Weave::Profiles::SoftwareUpdate::ProductSpec	代表產品規格的輔助類別。
nl::Weave::Profiles::SoftwareUpdate::UpdateSchemeList	包含更新配置清單的輔助類別，做為圖片查詢的一部分。
nl::Weave::Profiles::SoftwareUpdate::WeaveImageAnnounceServer	用於監聽 Weave 圖片公告的伺服器。

列舉

@309

 @309

SoftwareUpdate 訊息類型。

屬性
`kMsgType_DownloadNotify`	用戶端傳送給伺服器的選擇性訊息，用於通知伺服器關於下載狀態的資訊。其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport，其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。
`kMsgType_ImageAnnounce`	不請自來的不雅訊息，會由伺服器發出軟體更新通知。訊息沒有酬載。
`kMsgType_ImageQuery`	用戶端傳送至伺服器的查詢訊息。其格式是使用 ImageQuery 類別定義。
`kMsgType_ImageQueryResponse`	為成功成功的圖片查詢訊息而產生的訊息。其格式是由 ImageQueryResponse 類別定義。
`kMsgType_ImageQueryStatus`	為回應失敗的圖片查詢訊息而產生的訊息。其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport，其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。
`kMsgType_NotifyResponse`	為回應下載通知訊息而產生的訊息。其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport，其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。
`kMsgType_UpdateNotify`	用戶端傳送給伺服器的選用訊息，用於傳達更新的最終狀態。其酬載是 nl::Weave::Profiles::StatusReporting::StatusReport，其中包含從 SoftwareUpdateStatusCodes 擷取的其他狀態資訊。由於郵件預計會在實際更新後產生，因此會在新的 ExchangeContext 上傳送，而會視為伺服器上的來路不明的郵件。

@310

 @310

SoftwareUpdate 設定檔的特定狀態碼。

屬性
`kStatus_Abort`	server margingt; client，表示用戶端已無法連線，因此用戶端應該放棄。
`kStatus_DownloadFailed`	用戶端 margingt; 伺服器代表嘗試下載失敗。
`kStatus_IntegrityCheckFailed`	用戶端 ↓gt; 伺服器，表示已下載圖片，但後續的完整性檢查失敗。
`kStatus_InvalidInstructions`	用戶端 ↓gt; 伺服器，代表用戶端無法下載圖片，因為 ImageQueryResponse 中的下載指示 (例如 URI、更新配置、更新條件、格式不正確或不一致。
`kStatus_NoUpdateAvailable`	伺服器 margingt; 用戶端，代表已收到並理解圖片查詢，且伺服器目前無法對用戶端進行更新。
`kStatus_Retry`	server margingt; client 表示用戶端應提交其他圖片查詢，然後重新啟動/繼續更新。
`kStatus_UpdateFailed`	用戶端 margingt; 伺服器，表示嘗試安裝伺服器指定的映像檔失敗。

@311

 @311

ImageQuery 頁框控制項欄位的控制標記。

屬性
`kFlag_LocaleSpecPresent`	Locale 規格位於 ImageQuery。
`kFlag_PackageSpecPresent`	您可以在 ImageQuery 中找到套件規格。
`kFlag_TargetNodeIdPresent`	目標節點 ID 存在於 ImageQuery。

@312

 @312

ImageQueryResponse 的選擇性更新選項欄位的位元遮罩。

@313

 @313

ImageQueryResponse 的選用更新選項欄位位移。

@314

 @314

SoftwareUpdate 設定檔支援的完整性類型。

圖片查詢框架包含用戶端支援的完整性資訊，而圖片查詢回應包含完整性類型和值，而用戶端指示系統下載和安裝圖片。系統支援的類型如下：

屬性
`kIntegrityType_Last`	列舉中的有效元素數量。
`kIntegrityType_SHA160`	需要 160 位元安全雜湊 (SHA-1)。
`kIntegrityType_SHA256`	256 位元安全雜湊 (SHA-2)。
`kIntegrityType_SHA512`	512 位元、安全雜湊 (SHA-2)。

@315

 @315

完整性規格位元組字串的長度 (以位元組為單位)。

@316

 @316

由 SofwareUpdate 設定檔支援的更新配置。

與支援的完整性類型類似，圖片查詢內含更新機制的相關資訊，例如下載通訊協定、用戶端支援的，以及回應中包含用來下載更新配置值的值。支援的配置如下：

屬性
`kUpdateScheme_BDX`	您可以使用「大量資料傳輸」做為下載通訊協定。
`kUpdateScheme_HTTP`	使用 HTTP 做為下載通訊協定。
`kUpdateScheme_HTTPS`	將 HTTPS 用做下載通訊協定。
`kUpdateScheme_Last`	列舉中的有效元素數量。
`kUpdateScheme_SFTP`	應使用 SFTP 做為下載通訊協定。

@317

 @317

SoftwareUpdate 設定檔的資料元素標記。

UpdateCondition

 UpdateCondition

更新政策所規範的條件。

屬性
`IfLater`	如果回應框中的版本規格晚於目前安裝的軟體版本，請下載並安裝映像檔。
`IfUnmatched`	如果回應框中的版本規格與目前安裝的軟體版本不符，請下載並安裝圖片。
`OnOptIn`	在網站使用者提供的某些觸發條件上下載和安裝映像檔。
`Unconditionally`	無論目前執行的軟體版本為何，請下載並安裝映像檔。

更新優先順序

 UpdatePriority

更新優先順序。

屬性
`Critical`	必須立即執行更新。
`Normal`	可由客戶自行決定是否更新。

函式

完整性長度

int integrityLength(
  uint8_t aType
)

支援將 IntegrityTypes 值對應至該類型雜湊長度的方法。

詳細資料

參數

[in] aType

IntegrityTypes 值

傳回

所提供雜湊類型的雜湊長度。