Función Networking_Proxy_SetBasicAuthentication

Encabezado: #include <applibs/networking.h>

Establece el método de autenticación de proxy en básico.

Novedades la estructura de Networking_ProxyConfig especificada con el nuevo método de autenticación.

  int Networking_Proxy_SetBasicAuthentication(Networking_ProxyConfig *proxyConfig, const char *username, const char *password);

Parámetros

• proxyConfig Un puntero a la Networking_ProxyConfig struct para actualizar.

• username Puntero a la cadena que contiene el nombre de usuario que se usará para la autenticación.

• password Puntero a la cadena que contiene la contraseña que se usará para la autenticación.

Errores

Si se encuentra un error, devuelve -1 y establece errno el valor de error.

• EFAULT: El parámetro proxyConfig, nombre de usuario o contraseña es NULL.

• ERANGE: La longitud del nombre de usuario es mayor que PROXY_USERNAME_MAX_LENGTH o no termina en null, o la longitud de la contraseña es mayor que PROXY_PASSWORD_MAX_LENGTH o no termina en null.

También se puede especificar cualquier otro errno error; estos errores no son deterministas y no hay ninguna garantía de que el mismo comportamiento se conservará a través de las actualizaciones del sistema.

Devuelve

0 para el éxito, o -1 para el error, en cuyo caso errno se establecerá en el valor de error.

Conceptos y ejemplos

Los fragmentos de código proxy demuestran lo siguiente:

• En el fragmento de código Configurar configuración de proxy se muestra cómo configurar las opciones de proxy en un dispositivo Azure Sphere.
• El fragmento de código Obtener configuración de proxy muestra cómo recuperar la configuración de proxy en un dispositivo Azure Sphere.
• El fragmento de código de proxy configurado Habilitar/deshabilitar muestra cómo habilitar o deshabilitar un proxy ya configurado en un dispositivo Azure Sphere.

Los ejemplos de HTTPS demuestran el uso de las API de HTTPS_Curl_Easy y HTTPS_Curl_Multi para capturar contenido a través de HTTPS. De forma predeterminada, configuran el controlador cURL para usar un proxy.

El ejemplo de AzureIoT contiene instrucciones y código para agregar compatibilidad con proxy web al ejemplo.