Função Networking_Proxy_Apply

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

Aplica uma configuração de proxy ao dispositivo.

  int Networking_Proxy_Apply(const Networking_ProxyConfig *proxyConfig);

Parâmetros

• proxyConfig Um ponteiro para a estrutura Networking_ProxyConfig .

Erros

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

• EACCES: a aplicação de chamada não tem a capacidade NetworkConfig

• EFAULT: o parâmetro é 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.

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.

Requisitos do manifesto de aplicação

O manifesto da aplicação tem de incluir a capacidade NetworkConfig .