Share via


WifiConfig_SetClientCertStoreIdentifier functie

Header: #include <applibs/wificonfig.h>

Hiermee stelt u de id van het opgeslagen certificaat in dat moet worden gebruikt als het clientcertificaat voor een Wi-Fi-netwerk. De instelling is onmiddellijk van kracht, maar gaat verloren bij het opnieuw opstarten, tenzij de app WifiConfig_PersistConfig aanroept nadat deze functie wordt geretourneerd.

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

Parameters

  • networkId De id van het netwerk dat moet worden geconfigureerd. WifiConfig_AddNetwork retourneert de netwerk-id.

  • certStoreIdentifier Een verwijzing naar de naam van het certificaat. De naam moet een unieke tekenreeks zijn die één op CERTSTORE_MAX_IDENTIFIER_LENGTH bytes lang is, met uitzondering van het NULL-eindteken.

Fouten

Retourneert -1 als er een fout optreedt en wordt ingesteld errno op de foutwaarde.

  • EACCES: het toepassingsmanifest bevat niet de mogelijkheid EnterpriseWifiConfig .

  • EFAULT: de certStoreIdentifier parameter is NULL.

  • ERANGE: de lengte van de certStoreIdentifier parameter is groter dan CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: het Wi-Fi apparaat is niet gereed.

  • ENETDOWN: de Wi-Fi netwerkinterface is niet beschikbaar.

  • EINVAL: de networkId parameter is ongeldig.

  • ENODEV: de networkId parameter komt niet overeen met een van de id's van de opgeslagen netwerken.

errno Andere fouten kunnen ook worden opgegeven; dergelijke fouten zijn niet deterministisch en er is geen garantie dat hetzelfde gedrag wordt behouden via systeemupdates.

Retourwaarde

Retourneert 0 voor geslaagd, of -1 voor fout, in welk geval errno is ingesteld op de foutwaarde.

Vereisten voor toepassingsmanifest

Het toepassingsmanifest moet de mogelijkheid EnterpriseWifiConfig bevatten.