Networking_Proxy_Get

Artigo
08/09/2023

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

Obtém a configuração do proxy a partir do dispositivo.

  int Networking_Proxy_Get(Networking_ProxyConfig *proxyConfig);

Parâmetros

proxyConfig O ponteiro para a estrutura Networking_ProxyConfig que irá receber a configuração do proxy.

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 ou ReadNetworkProxyConfig.
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.

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 ou ReadNetworkProxyConfig.

Partilhar via