Функция Networking_Proxy_SetProxyAddress

Заголовок: #include <applibs/networking.h>

Задает адрес прокси-сервера для структуры Networking_ProxyConfig .

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

Параметры

• proxyConfig Указатель на структуру Networking_ProxyConfig для обновления.

• proxyAddress Указатель на строку, завершающую значение NULL, содержащую адрес прокси-сервера.

• proxyPort Порт, используемый на прокси-сервере.

Ошибки

При обнаружении ошибки возвращает значение -1 и задает errno значение ошибки.

• EFAULT: параметр proxyConfig или proxyAddress имеет значение NULL.

• ERANGE: длина proxyAddress больше PROXY_ADDRESS_MAX_LENGTH или не заканчивается null.

Можно также указать любой другой errno вариант. Такие ошибки не являются детерминированными, и нет никакой гарантии, что такое же поведение будет сохранено при обновлении системы.

Возвращает

0 для успешного выполнения или -1 для сбоя. В этом случае errno будет задано значение ошибки.

Основные понятия и примеры

Фрагменты кода прокси-сервера демонстрируют следующее:

• В фрагменте кода Настройка параметров прокси-сервера показано, как настроить параметры прокси-сервера на устройстве Azure Sphere.
• В фрагменте кода Get Proxy Settings показано, как получить параметры прокси-сервера на устройстве Azure Sphere.
• В фрагменте кода включения и отключения настроенного прокси-сервера показано, как включить или отключить уже настроенный прокси-сервер на устройстве Azure Sphere.

Примеры HTTPS демонстрируют использование API HTTPS_Curl_Easy и HTTPS_Curl_Multi для получения содержимого по протоколу HTTPS. По умолчанию они настраивают дескриптор cURL для использования прокси-сервера.

Пример AzureIoT содержит инструкции и код для добавления поддержки веб-прокси в пример.