função WifiConfig_SetRootCACertStoreIdentifier

  • Artigo

Cabeçalho: #include <applibs/wificonfig.h>

Define o identificador do certificado armazenado a ser usado como a autoridade de certificado raiz de uma rede. Se o identificador não estiver definido, o dispositivo não autenticará o servidor ao qual ele se conecta. A configuração é efetiva imediatamente, mas será perdida em uma reinicialização, a menos que a função WifiConfig_PersistConfig seja chamada após essa função.

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

Parâmetros

  • networkId A ID da rede para a qual definir o identificador do repositório de certificados. WifiConfig_AddNetwork retorna a ID da rede.

  • certStoreIdentifier Um ponteiro para a cadeia de caracteres terminada nulo constante que contém o nome do certificado. O nome deve ser uma cadeia de caracteres exclusiva de um para CERTSTORE_MAX_IDENTIFIER_LENGTH caracteres de comprimento. Consulte CertStore_InstallRootCACertificate função para obter detalhes.

Erros

Retorna -1 se um erro for encontrado e definir errno como o valor do erro.

  • EACCES: o manifesto do aplicativo não inclui a funcionalidade EnterpriseWifiConfig.

  • EFAULT: o certStoreIdentifier parâmetro é NULL.

  • ERANGE: o comprimento do certStoreIdentifier parâmetro é maior que CERTSTORE_MAX_IDENTIFIER_LENGTH.

  • EAGAIN: o dispositivo Wi-Fi não está pronto.

  • ENETDOWN: a interface de rede Wi-Fi não está disponível.

  • EINVAL: o networkId parâmetro é inválido.

  • ENODEV: o networkId parâmetro não corresponde a nenhuma das IDs das redes armazenadas.

Qualquer outro errno também pode ser especificado; esses erros não são determinísticos e não há garantia de que o mesmo comportamento será mantido por meio de atualizações do sistema.

Valor retornado

Retorna 0 para êxito ou -1 para falha, nesse caso errno é definido como o valor do erro.

Requisitos de manifesto do aplicativo

O manifesto do aplicativo deve incluir o recurso EnterpriseWifiConfig.