Share via

CertStore_MoveCertificate işlevi

  • Makale

Üst bilgi: #include <applibs/certstore.h>

Sertifikayı yeniden adlandırır. Her iki sertifika da sertifika deposunda zaten yüklü olmalıdır.

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

Parametre

  • sourceIdentifier Sertifikanın geçerli kimliği.

  • destIdentifier Sertifikanın yeni kimliği.

Hata

Hatayla karşılaşılırsa ve hata değerine ayarlanırsa errno -1 döndürür.

  • EACCES: Uygulama bildiriminde CertStore özelliği ayarlanmadığı için işleme izin verilmez.

  • EAGAIN: İşletim sistemi sertifika deposu bileşeni henüz hazır değil.

  • EFAULT: sourceIdentifier or destIdentifier parametresi NULL'dir.

  • EINVAL: sourceIdentifier veya destIdentifier parametresi geçerli bir tanımlayıcı adı değil.

  • ENOENT: Tanımlayıcıya sourceIdentifier sahip sertifika yok.

Diğer errno hatalar da belirtilebilir; bu tür hatalar belirleyici değildir ve sistem güncelleştirmeleri aracılığıyla aynı davranışın korunacağının garantisi yoktur.

Dönüş değeri

Başarı için 0 veya hata için -1 döndürür; bu durumda errno hata değerine ayarlanır.

Uygulama bildirimi gereksinimleri

Uygulama bildirimi CertStore özelliğini içermelidir.

Açıklamalar

Tanımlayıcıya destIdentifier sahip herhangi bir sertifika türü zaten varsa, konumundaki sertifikanın sourceIdentifieriçeriğiyle değiştirilir ve sourceidentifier artık mevcut olmaz.

Dikkat

Sertifika kimlikleri sistem genelinde olduğundan, azsphere komutu veya yeni sertifika ekleyen bir işlev çağrısı, önceki bir komut veya işlev çağrısı tarafından eklenen bir sertifikanın üzerine yazabilir ve bu da ağ bağlantısı hatalarına neden olabilir. Net sertifika güncelleştirme yordamları geliştirmenizi ve sertifika kimliklerini dikkatle seçmenizi kesinlikle öneririz.

Azure Sphere'ın sertifika kimliklerini nasıl kullandığı hakkında daha fazla bilgi için bkz. Sertifika Kimlikleri.

Bu işlev sertifikaları yeniden adlandırır ancak kullanıldıkları yapılandırmaları güncelleştirmez. Yeniden adlandırılan sertifikaları kullanmak için uygulamanın WifiConfig_ReloadConfig çağırarak Wi-Fi yapılandırmasını yeniden yüklemesi gerekir. Yalnızca sourceIdentifier öğesini kullanan Wi-Fi yapılandırmaları geçerli bir tanımlayıcı kullanacak şekilde güncelleştirilmelidir.