다음을 통해 공유

CertStore_MoveCertificate 함수

  • 아티클

헤더: #include <applibs/certstore.h>

인증서 이름을 바꿉니다. 두 인증서 모두 인증서 저장소에 이미 설치되어 있어야 합니다.

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

매개 변수

  • sourceIdentifier 인증서의 현재 ID입니다.

  • destIdentifier 인증서의 새 ID입니다.

오류

오류가 발생하고 를 오류 값으로 설정 errno 하면 -1을 반환합니다.

  • 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 유효한 식별자를 사용하도록 업데이트해야 합니다.