Partilhar via

Função WifiConfig_SetClientCertStoreIdentifier

  • Artigo

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

Define o identificador do certificado armazenado para utilizar como certificado de cliente de uma rede Wi-Fi. A definição tem efeito imediato, mas perder-se-á durante um reinício, a menos que a aplicação chame WifiConfig_PersistConfig após a devolução desta função.

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

Parâmetros

  • networkId O ID da rede a configurar. WifiConfig_AddNetwork devolve o ID de rede.

  • certStoreIdentifier Um ponteiro para o nome do certificado. O nome tem de ser uma cadeia exclusiva com um bytes CERTSTORE_MAX_IDENTIFIER_LENGTH longo, excluindo o caráter de terminador NULL.

Erros

Devolve -1 se ocorrer 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.