Partilhar via

Função Networking_Proxy_SetBasicAuthentication

  • Artigo

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

Define o método de autenticação de proxy como básico.

Atualizações a estrutura de Networking_ProxyConfig especificada 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 a estrutura do Networking_ProxyConfig a atualizar.

  • username Um ponteiro para a cadeia que contém o nome de utilizador a utilizar para autenticação.

  • password Um ponteiro para a cadeia que contém a palavra-passe a utilizar para autenticação.

Erros

Se for encontrado um erro, devolve -1 e define errno para o valor de erro.

  • EFAULT: o parâmetro proxyConfig, nome de utilizador ou palavra-passe é NULL.

  • ERANGE: o comprimento do nome de utilizador é maior do que PROXY_USERNAME_MAX_LENGTH ou não é terminado nulo, ou o comprimento da palavra-passe é maior do que PROXY_PASSWORD_MAX_LENGTH ou não é terminado de forma nula.

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.

Devoluções

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

Conceitos e exemplos

Os fragmentos de código de proxy demonstram o seguinte:

Os exemplos de HTTPS demonstram a utilização das APIs HTTPS_Curl_Easy e HTTPS_Curl_Multi para obter conteúdo através de HTTPS. Por predefinição, configuram o identificador cURL para utilizar um proxy.

O exemplo do AzureIoT contém instruções e código para adicionar suporte de proxy Web ao exemplo.