Partilhar via

função WifiConfig_SetRootCACertStoreIdentifier

  • Artigo

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

Define o identificador do certificado armazenado para utilizar como autoridade de certificação de raiz para uma rede. Se o identificador não estiver definido, o dispositivo não autenticará o servidor ao qual se liga. A definição tem efeito imediato, mas perder-se-á durante um reinício, a menos que a função WifiConfig_PersistConfig seja chamada após esta função.

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

Parâmetros

  • networkId O ID da rede para a qual definir o identificador do arquivo de certificados. WifiConfig_AddNetwork devolve o ID de rede.

  • certStoreIdentifier Um ponteiro para uma cadeia de carateres com terminação nula constante que contém o nome do certificado. O nome tem de ser uma cadeia exclusiva de um para CERTSTORE_MAX_IDENTIFIER_LENGTH um carateres de comprimento. Veja CertStore_InstallRootCACertificate função para obter detalhes.

Erros

Devolve -1 se for encontrado um erro e define errno para o valor de erro.

  • EACCES: o manifesto da aplicação não inclui a capacidade 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 nenhum dos IDs das redes armazenadas.

Qualquer outro errno também pode ser especificado; tais erros não são deterministas e não há garantias de que o mesmo comportamento será mantido através de atualizações do sistema.

Valor devolvido

Devolve 0 para êxito ou -1 para falha, caso errno em que está definido como o valor de erro.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir a capacidade EnterpriseWifiConfig.