Networking_Proxy_SetProxyAddress, fonction

En-tête : #include <applibs/networking.h>

Définit l’adresse proxy d’un struct Networking_ProxyConfig .

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

Paramètres

• proxyConfig Pointeur vers le struct Networking_ProxyConfig à mettre à jour.

• proxyAddress Pointeur vers une chaîne terminée par null contenant l’adresse du proxy.

• proxyPort Port à utiliser sur le proxy.

Erreurs

Si une erreur est rencontrée, retourne -1 et définit errno sur la valeur d’erreur.

• EFAULT : le paramètre proxyConfig ou proxyAddress a la valeur NULL.

• ERANGE : la longueur de proxyAddress est supérieure à PROXY_ADDRESS_MAX_LENGTH ou n’est pas terminée par null.

Toutes les autres errno peuvent également être spécifiées ; ces erreurs ne sont pas déterministes et il n’existe aucune garantie que le même comportement sera conservé via les mises à jour système.

Retourne

0 pour la réussite, ou -1 pour l’échec, auquel cas errno est défini sur la valeur d’erreur.

Concepts et exemples

Les extraits de code proxy illustrent les éléments suivants :

• L’extrait de code Configurer les paramètres de proxy montre comment configurer les paramètres de proxy sur un appareil Azure Sphere.
• L’extrait de code Obtenir les paramètres du proxy montre comment récupérer les paramètres de proxy sur un appareil Azure Sphere.
• L’extrait de code Activer/Désactiver le proxy configuré montre comment activer/désactiver un proxy déjà configuré sur un appareil Azure Sphere.

Les exemples HTTPS illustrent l’utilisation des API HTTPS_Curl_Easy et HTTPS_Curl_Multi pour extraire du contenu via HTTPS. Par défaut, ils configurent le handle cURL pour utiliser un proxy.

L’exemple AzureIoT contient des instructions et du code pour ajouter la prise en charge du proxy web à l’exemple.