Função Networking_Proxy_SetBasicAuthentication
Cabeçalho: #include <applibs/networking.h>
Define o método de autenticação de proxy como básico.
Atualizações o struct Networking_ProxyConfig especificado com o novo método de autenticação.
int Networking_Proxy_SetBasicAuthentication(Networking_ProxyConfig *proxyConfig, const char *username, const char *password);
Parâmetros
proxyConfig
Um ponteiro para o struct Networking_ProxyConfig para atualizar.username
Um ponteiro para a cadeia de caracteres que contém o nome de usuário a ser usado para autenticação.password
Um ponteiro para a cadeia de caracteres que contém a senha a ser usada para autenticação.
Erros
Se um erro for encontrado, retornará -1 e definirá errno
para o valor de erro.
EFAULT: o parâmetro proxyConfig, nome de usuário ou senha é NULL.
ERANGE: o comprimento do nome de usuário é maior que PROXY_USERNAME_MAX_LENGTH ou não é encerrado nulo ou o comprimento da senha é maior que PROXY_PASSWORD_MAX_LENGTH ou não é encerrado em nulo.
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.
Retorna
0 para êxito ou -1 para falha, nesse caso errno
, será definido como o valor do erro.
Conceitos e exemplos
Os snippets de código proxy demonstram o seguinte:
- O snippet de código Configurar Configurações de Proxy demonstra como configurar as configurações de proxy em um dispositivo do Azure Sphere.
- O snippet de código Obter Configurações de Proxy demonstra como recuperar as configurações de proxy em um dispositivo do Azure Sphere.
- O snippet de código Enable/Disable Configured Proxy demonstra como habilitar/desabilitar um proxy já configurado em um dispositivo do Azure Sphere.
Os exemplos HTTPS demonstram o uso das APIs HTTPS_Curl_Easy e HTTPS_Curl_Multi para buscar conteúdo por HTTPS. Por padrão, eles configuram o identificador cURL para usar um proxy.
O exemplo do AzureIoT contém instruções e código para adicionar suporte a proxy Web ao exemplo.