Função Networking_Proxy_SetProxyAddress

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

Define o endereço proxy para um struct de Networking_ProxyConfig .

  int Networking_Proxy_SetProxyAddress(Networking_ProxyConfig *proxyConfig, const char *proxyAddress, uint16_t proxyPort);

Parâmetros

• proxyConfig Um ponteiro para o struct Networking_ProxyConfig para atualizar.

• proxyAddress Um ponteiro para uma cadeia de caracteres terminada nulo que contém o endereço do proxy.

• proxyPort A porta a ser usada no proxy.

Erros

Se um erro for encontrado, retornará -1 e definirá errno para o valor de erro.

• EFAULT: o parâmetro proxyConfig ou proxyAddress é NULL.

• ERANGE: o comprimento proxyAddress é maior que PROXY_ADDRESS_MAX_LENGTH ou não é encerrado 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.