Função Networking_Proxy_SetProxyOptions

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

Define opções de proxy para uma estrutura Networking_ProxyConfig .

  int Networking_Proxy_SetProxyOptions(Networking_ProxyConfig *proxyConfig, Networking_ProxyOptions proxyOptions);

Parâmetros

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

• proxyOptions O valor Networking_ProxyOptions que contém as opções de proxy.

Erros

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

• EFAULT: o parâmetro proxyConfig é NULL.

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.

Observações

Por predefinição, as definições de configuração são preservadas quando o proxy é desativado. Não é necessário fornecer as definições novamente quando o proxy é reativado.

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.