Share via

CertStore_MoveCertificate関数

  • [アーティクル]

ヘッダー: applibs </certstore.h #include>

証明書の名前を変更します。 両方の証明書が証明書ストアに既にインストールされている必要があります。

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

パラメーター

  • sourceIdentifier 証明書の現在の ID。

  • destIdentifier 証明書の新しい ID。

エラー

エラーが発生した場合は -1 を返し、エラー値に設定します errno 。

  • EACCES: CertStore 機能がアプリケーション マニフェストに設定されていないため、操作は許可されません。

  • EAGAIN: OS 証明書ストア コンポーネントはまだ準備ができていません。

  • EFAULT: sourceIdentifier または destIdentifier パラメーターが NULL です。

  • EINVAL: sourceIdentifier または destIdentifier パラメーターが有効な識別子名ではありません。

  • ENOENT: 識別子 sourceIdentifier を持つ証明書が存在しません。

その他 errno のエラーも指定できます。このようなエラーは決定的ではなく、システムの更新によって同じ動作が保持される保証はありません。

戻り値

成功の場合は 0、失敗の場合は -1 を返します。この場合 errno はエラー値に設定されます。

アプリケーション マニフェストの要件

アプリケーション マニフェストには、CertStore 機能が含まれている必要があります。

発言

識別子 destIdentifier を持つ任意の種類の証明書が既に存在する場合は、 の証明書の内容に sourceIdentifier置き換えられ、 sourceidentifier は存在しなくなります。

注意

証明書 ID はシステム全体であるため、新しい証明書を az sphere 追加するコマンドまたは関数呼び出しによって、以前のコマンドまたは関数呼び出しによって追加された証明書が上書きされ、ネットワーク接続エラーが発生する可能性があります。 明確な証明書の更新手順を開発し、証明書 ID を慎重に選択することを強くお勧めします。

Azure Sphere で証明書 ID を使用する 方法の詳細については、「証明書 ID」を参照してください。

この関数は証明書の名前を変更しますが、使用されている構成は更新されません。 名前が変更された証明書を使用するには、 WifiConfig_ReloadConfigを呼び出して Wi-Fi 構成を再読み込みする必要があります。 のみを使用する Wi-Fi 構成は sourceIdentifier 、有効な識別子を使用するように更新する必要があります。