WifiConfig_SetRootCACertStoreIdentifier-Funktion

  • Artikel

Header: #include <applibs/wificonfig.h>

Legt den Bezeichner des gespeicherten Zertifikats fest, das als Stammzertifizierungsstelle für ein Netzwerk verwendet werden soll. Wenn der Bezeichner nicht festgelegt ist, authentifiziert das Gerät den Server nicht, mit dem es eine Verbindung herstellt. Die Einstellung wird sofort wirksam, geht aber bei einem Neustart verloren, es sei denn, die WifiConfig_PersistConfig Funktion wird nach dieser Funktion aufgerufen.

static int WifiConfig_SetRootCACertStoreIdentifier(int networkId, const char *certStoreIdentifier);

Parameter

  • networkId Die ID des Netzwerks, für das der Zertifikatspeicherbezeichner festgelegt werden soll. WifiConfig_AddNetwork gibt die Netzwerk-ID zurück.

  • certStoreIdentifier Ein Zeiger auf eine mit NULL endende konstante Zeichenfolge, die den Namen des Zertifikats enthält. Der Name muss eine eindeutige Zeichenfolge von 1 bis zeichenlänge CERTSTORE_MAX_IDENTIFIER_LENGTH sein. Weitere Informationen finden Sie unter CertStore_InstallRootCACertificate-Funktion .

Fehler

Gibt -1 zurück, wenn ein Fehler auftritt, und legt auf den Fehlerwert fest errno .

  • EACCES: Das Anwendungsmanifest enthält nicht die EnterpriseWifiConfig-Funktion.

  • EFAULT: Der certStoreIdentifier Parameter ist NULL.

  • ERANGE: Die Länge des certStoreIdentifier Parameters ist größer als CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: Das Wi-Fi Gerät ist nicht bereit.

  • ENETDOWN: Die Wi-Fi Netzwerkschnittstelle ist nicht verfügbar.

  • EINVAL: Der networkId Parameter ist ungültig.

  • ENODEV: Der networkId Parameter stimmt mit keiner der IDs der gespeicherten Netzwerke überein.

Auch andere errno Fehler können angegeben werden. Solche Fehler sind nicht deterministisch, und es gibt keine Garantie, dass das gleiche Verhalten durch Systemupdates beibehalten wird.

Rückgabewert

Gibt 0 für erfolg oder -1 für Fehler zurück. In diesem Fall errno wird auf den Fehlerwert festgelegt.

Anforderungen an das Anwendungsmanifest

Das Anwendungsmanifest muss die EnterpriseWifiConfig-Funktion enthalten.