Función WinHttpDetectAutoProxyConfigUrl (winhttp.h)

  • Artículo

La función WinHttpDetectAutoProxyConfigUrl busca la dirección URL del archivo de configuración automática de proxy (PAC). Esta función notifica la dirección URL del archivo PAC, pero no descarga el archivo.

Sintaxis

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

Parámetros

[in] dwAutoDetectFlags

Tipo de datos que especifica qué protocolos usar para localizar el archivo PAC. Si se establecen las marcas de detección automática de DHCP y DNS, primero se usa DHCP; si no se detecta ninguna dirección URL de PAC mediante DHCP, se usa DNS.

Value Significado
WINHTTP_AUTO_DETECT_TYPE_DHCP
 Use DHCP para buscar el archivo de configuración automática del proxy.
WINHTTP_AUTO_DETECT_TYPE_DNS_A
 Use DNS para intentar localizar el archivo de configuración automática del proxy en una ubicación conocida en el dominio del equipo local.

[out] ppwstrAutoConfigUrl

Tipo de datos que devuelve un puntero a una cadena Unicode terminada en null que contiene la dirección URL de configuración que recibe los datos del proxy. Debe liberar la cadena a la que apunta ppwszAutoConfigUrl mediante la función GlobalFree .

Valor devuelto

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario. Para obtener información de error extendida, llame a GetLastError. Entre los códigos de error devueltos se incluyen los siguientes.

Código de error Descripción
ERROR_WINHTTP_AUTODETECTION_FAILED
 Se devuelve si WinHTTP no pudo detectar la dirección URL del archivo de configuración automática de proxy (PAC).
ERROR_WINHTTP_INTERNAL_ERROR
 Se ha producido un error interno.
ERROR_NOT_ENOUGH_MEMORY
 No había suficiente memoria disponible para completar la operación solicitada. (Código de error de Windows)

Comentarios

WinHTTP implementa el protocolo de detección automática de proxy web (WPAD), a menudo denominado autoproxy. Para obtener más información sobre las ubicaciones conocidas, vea la sección Proceso de detección del documento protocolo WPAD.

Tenga en cuenta que, dado que la función WinHttpDetectAutoProxyConfigUrl tarda tiempo en completar su operación, no se debe llamar desde un subproceso de interfaz de usuario.

Requisitos

   
Cliente mínimo compatible Windows XP, Windows 2000 Professional con SP3 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003, Windows 2000 Server con SP3 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll

Consulte también

Versiones winHTTP