Udostępnij za pośrednictwem

funkcja CertStore_MoveCertificate

  • Artykuł

Nagłówek: #include <applibs/certstore.h>

Zmienia nazwę certyfikatu. Oba certyfikaty muszą już być zainstalowane w magazynie certyfikatów.

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

Parametry

  • sourceIdentifier Bieżący identyfikator certyfikatu.

  • destIdentifier Nowy identyfikator certyfikatu.

Błędy

Zwraca wartość -1 w przypadku napotkania błędu i ustawia errno wartość błędu.

  • EACCES: operacja jest niedozwolona, ponieważ funkcja CertStore nie jest ustawiona w manifeście aplikacji.

  • EAGAIN: składnik magazynu certyfikatów systemu operacyjnego nie jest jeszcze gotowy.

  • EFAULT: sourceIdentifier lub destIdentifier parametr ma wartość NULL.

  • EINVAL: sourceIdentifier lub destIdentifier parametr nie jest prawidłową nazwą identyfikatora.

  • ENOENT: certyfikat z identyfikatorem sourceIdentifier nie istnieje.

Mogą być również określone inne errno błędy; takie błędy nie są deterministyczne i nie ma gwarancji, że to samo zachowanie zostanie zachowane za pośrednictwem aktualizacji systemu.

Zwracana wartość

Zwraca wartość 0 dla powodzenia lub -1 dla niepowodzenia, w którym to przypadku errno jest ustawiona wartość błędu.

Wymagania dotyczące manifestu aplikacji

Manifest aplikacji musi zawierać funkcję CertStore.

Uwagi

Jeśli jakikolwiek typ certyfikatu z identyfikatorem destIdentifier już istnieje, zostanie on zastąpiony zawartością certyfikatu w witrynie sourceIdentifier, a sourceidentifier certyfikat już nie będzie istniał.

Ostrożność

Ponieważ identyfikatory certyfikatów są w całym systemie, az sphere wywołanie polecenia lub funkcji, które dodaje nowy certyfikat, może zastąpić certyfikat dodany przez wcześniejsze wywołanie polecenia lub funkcji, co może powodować awarie połączenia sieciowego. Zdecydowanie zalecamy opracowanie przejrzystych procedur aktualizacji certyfikatów i staranne wybieranie identyfikatorów certyfikatów.

Zobacz Identyfikatory certyfikatów , aby uzyskać więcej informacji o tym, jak usługa Azure Sphere korzysta z identyfikatorów certyfikatów.

Ta funkcja zmienia nazwy certyfikatów, ale nie aktualizuje konfiguracji, w których są używane. Aby używać certyfikatów o zmienionej nazwie, aplikacja musi ponownie załadować konfigurację Wi-Fi, wywołując WifiConfig_ReloadConfig. Wi-Fi konfiguracje używające tylko tych konfiguracji sourceIdentifier muszą zostać zaktualizowane, aby użyć prawidłowego identyfikatora.