Função Networking_Proxy_SetProxyAddress

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

Define o endereço proxy de uma estrutura Networking_ProxyConfig .

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

Parâmetros

• proxyConfig Um ponteiro para a estrutura do Networking_ProxyConfig a atualizar.

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

• proxyPort A porta a utilizar no proxy.

Erros

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

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

• ERANGE: o comprimento do proxyAddress é maior do que PROXY_ADDRESS_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:

• O fragmento de código Configurar Definições de Proxy demonstra como configurar as definições de proxy num dispositivo do Azure Sphere.
• O fragmento de código Obter Definições de Proxy demonstra como obter as definições de proxy num dispositivo do Azure Sphere.
• O fragmento de código Ativar/Desativar Proxy Configurado demonstra como ativar/desativar um proxy já configurado num dispositivo do Azure Sphere.

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.