共用方式為

CertStore_MoveCertificate函數

  • 發行項

頁首： #include < applibs/certstore。h>

重新命名憑證。 這兩個憑證都必須安裝在憑證存放區中。

int CertStore_MoveCertificate(const char *sourceIdentifier, const char *destIdentifier);

參數

  • sourceIdentifier 憑證的目前識別碼。

  • destIdentifier 憑證的新識別碼。

錯誤

如果發生錯誤並設定為 errno 錯誤值，則傳回 -1。

  • EACCES：由於 CertStore 功能未在應用程式資訊清單中設定，因此不允許執行此作業。

  • EAGAIN：作業系統憑證儲存元件尚未準備就緒。

  • EFAULT：或 sourceIdentifierdestIdentifier 參數為 Null。

  • EINVAL： sourceIdentifier 或 destIdentifier 參數不是有效的識別碼名稱。

  • ENOENT：識別碼 sourceIdentifier 的憑證不存在。

您也可以指定任何其他 errno 錯誤;這類錯誤並非確定性錯誤，而且不保證會透過系統更新保留相同的行為。

傳回值

會傳回 0 表示成功，而失敗則傳回 -1，在這種情況下 errno 會設定為錯誤值。

應用程式資訊清單需求

應用程式 資訊清單 必須包含 CertStore 功能。

言論

如果任何一種含有識別碼 destIdentifier 的憑證已存在，則會以 sourceIdentifier ， 而該憑證的內容將會取代為 ， 且 sourceidentifier 將不再存在。

謹慎

由於憑證識別碼是全系統，因此新增憑證的 azsphere 命令或函數呼叫可能會覆寫先前命令或函數通話所新增的憑證，而可能導致網路連線失敗。 我們強烈建議您開發清楚的憑證更新程式，並謹慎選擇憑證識別碼。

如需Azure 球體如何使用憑證識別碼的詳細資訊，請參閱憑證識別碼。

此函數會重新命名憑證，但不會更新使用憑證的設定。 若要使用重新命名的憑證，應用程式必須透過呼叫WifiConfig_ReloadConfig重載 Wi-Fi設定。 Wi-Fi 只使用識別碼的 sourceIdentifier 設定必須更新，才能使用有效的識別碼。