estructura INTERNET_PER_CONN_OPTIONA (wininet.h)

  • Artículo

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 en el 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 valores siguientes:
AUTO_PROXY_FLAG_ALWAYS_DETECT
Detectar siempre la configuración automáticamente.
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 valores siguientes:
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
 Dirección 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 configuración automática correcta 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 encontrada 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 valores siguientes:
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

Comentarios

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

Para 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 los servicios HTTP de Microsoft Windows (WinHTTP).
 

Nota

El encabezado wininet.h define INTERNET_PER_CONN_OPTION como un 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado wininet.h

Consulte también

INTERNET_PER_CONN_OPTION_LIST

InternetQueryOption

InternetSetOption