estructura INTERNET_PER_CONN_OPTIONA (wininet.h)

Contiene el valor de una opción.

Sintaxis

typedef struct {
  DWORD dwOption;
  union {
    DWORD    dwValue;
    LPSTR    pszValue;
    FILETIME ftValue;
  } Value;
} INTERNET_PER_CONN_OPTIONA, *LPINTERNET_PER_CONN_OPTIONA;

Miembros

dwOption

Opción que se va a consultar o establecer. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
INTERNET_PER_CONN_AUTOCONFIG_URL	Establece o recupera una cadena que contiene la dirección URL al script de configuración automática.
INTERNET_PER_CONN_AUTODISCOVERY_FLAGS	Establece o recupera la configuración de detección automática. El miembro Value contendrá uno o varios de los siguientes valores: AUTO_PROXY_FLAG_ALWAYS_DETECT Detectar siempre automáticamente la configuración. AUTO_PROXY_FLAG_CACHE_INIT_RUN Indica que se deben usar los resultados almacenados en caché del script de configuración de proxy automático, en lugar de ejecutar realmente el script, a menos que el archivo almacenado en caché haya expirado. AUTO_PROXY_FLAG_DETECTION_RUN La detección automática se ha ejecutado al menos una vez en esta conexión. AUTO_PROXY_FLAG_DETECTION_SUSPECT Actualmente no se admite. AUTO_PROXY_FLAG_DONT_CACHE_PROXY_RESULT No permita el almacenamiento en caché del resultado del script de configuración de proxy automático. AUTO_PROXY_FLAG_MIGRATED La configuración se migró desde una instalación de Microsoft Internet Explorer 4.0 y se debe intentar la detección automática una vez. AUTO_PROXY_FLAG_USER_SET El usuario ha establecido explícitamente la detección automática.
INTERNET_PER_CONN_FLAGS	Establece o recupera el tipo de conexión. El miembro Value contendrá uno o varios de los siguientes valores: PROXY_TYPE_DIRECT La conexión no usa un servidor proxy. PROXY_TYPE_PROXY La conexión usa un servidor proxy establecido explícitamente. PROXY_TYPE_AUTO_PROXY_URL La conexión descarga y procesa un script de configuración automática en una dirección URL especificada. PROXY_TYPE_AUTO_DETECT La conexión detecta automáticamente la configuración.
INTERNET_PER_CONN_PROXY_BYPASS	Establece o recupera una cadena que contiene las direcciones URL que no usan el servidor proxy.
INTERNET_PER_CONN_PROXY_SERVER	Establece o recupera una cadena que contiene los servidores proxy.
INTERNET_PER_CONN_AUTOCONFIG_SECONDARY_URL	Url de configuración automática encadenada. Se usa cuando la dirección URL de configuración automática principal apunta a un archivo INS que establece una segunda dirección URL de configuración automática para la información del proxy.
INTERNET_PER_CONN_AUTOCONFIG_RELOAD_DELAY_MINS	de minutos hasta la actualización automática de la dirección URL de configuración automática por detección automática.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_TIME	Opción de solo lectura. Devuelve la hora en que se encontró la última dirección URL de autoconfiguración automática conocida mediante la detección automática.
INTERNET_PER_CONN_AUTOCONFIG_LAST_DETECT_URL	Opción de solo lectura. Devuelve la última dirección URL correcta conocida que se encuentra mediante la detección automática.

 

Windows 7 y versiones posteriores:

Los clientes que admiten Internet Explorer 8 deben consultar el tipo de conexión mediante INTERNET_PER_CONN_FLAGS_UI. Si se produce un error en esta consulta, el sistema ejecuta una versión anterior de Internet Explorer y el cliente debe consultar de nuevo con INTERNET_PER_CONN_FLAGS.

Restaure el tipo de conexión mediante INTERNET_PER_CONN_FLAGS independientemente de la versión de Internet Explorer.

Valor

Significado

INTERNET_PER_CONN_FLAGS_UI

Establece o recupera el tipo de conexión. El miembro Value contendrá uno o varios de los siguientes valores: PROXY_TYPE_DIRECT La conexión no usa un servidor proxy. PROXY_TYPE_PROXY La conexión usa un servidor proxy establecido explícitamente. PROXY_TYPE_AUTO_PROXY_URL La conexión descarga y procesa un script de configuración automática en una dirección URL especificada. PROXY_TYPE_AUTO_DETECT La conexión detecta automáticamente la configuración.

Value

Unión que contiene el valor de la opción . Puede ser cualquiera de los siguientes tipos en función del valor de dwOption:

dwValue

Valor entero largo sin signo.

pszValue

Puntero a un valor de cadena.

ftValue

Estructura FILETIME.

Value.dwValue

Value.pszValue

Value.ftValue

Observaciones

En Internet Explorer 5, solo las versiones ANSI de InternetQueryOption y InternetSetOption funcionarán con la estructura INTERNET_PER_CONN_OPTION. Las versiones Unicode admitirán la estructura INTERNET_PER_CONN_OPTION en versiones posteriores de Internet Explorer.

En el caso de las consultas que devuelven cadenas, internetQueryOption asigna la memoria para el miembro pszValue de la estructura. La aplicación que realiza la llamada debe liberar esta memoria mediante la función GlobalFree cuando haya terminado de usar la cadena.

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).

 

Nota

El encabezado wininet.h define INTERNET_PER_CONN_OPTION como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
encabezado de	wininet.h

Consulte también

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

internetSetOption