Compartilhar via


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:

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.