Marcas de opción (Wininet.h)

Las siguientes marcas de opción se usan con las funciones InternetQueryOption e InternetSetOption . Todas las marcas de opción válidas tienen un valor mayor o igual que INTERNET_FIRST_OPTION y menor o igual que INTERNET_LAST_OPTION.

INTERNET_OPTION_ALTER_IDENTITY

80

No implementado

INTERNET_OPTION_ASYNC

30

Sin implementar.

INTERNET_OPTION_ASYNC_ID

15

Sin implementar.

INTERNET_OPTION_ASYNC_PRIORITY

16

Sin implementar.

INTERNET_OPTION_BYPASS_EDITED_ENTRY

64

Establece o recupera el valor booleano que determina si el sistema debe comprobar la red para obtener contenido más reciente y sobrescribir entradas de caché editadas si se encuentra una versión más reciente. Si se establece en True, el sistema comprueba la red para obtener contenido más reciente y sobrescribe la entrada de caché editada con la versión más reciente. El valor predeterminado es False, lo que indica que se debe usar la entrada de caché editada sin comprobar la red. Esto lo usa InternetQueryOption e InternetSetOption. Solo es válido en Microsoft Internet Explorer 5 y versiones posteriores.

INTERNET_OPTION_CACHE_STREAM_HANDLE

27

Ya no se admite.

INTERNET_OPTION_CACHE_TIMESTAMPS

69

Recupera una estructura de INTERNET_CACHE_TIMESTAMPS que contiene la hora LastModified y Expira el tiempo del recurso almacenado en la memoria caché de Internet. InternetQueryOption usa este valor.

INTERNET_OPTION_CALLBACK

1

Establece o recupera la dirección de la función de devolución de llamada definida para este identificador. Esta opción se puede usar en todos los identificadores HINTERNET . Usado por InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CALLBACK_FILTER

54

Sin implementar.

INTERNET_OPTION_CLIENT_CERT_CONTEXT

84

Esta marca no es compatible con InternetQueryOption. El parámetro lpBuffer debe ser un puntero a una estructura de CERT_CONTEXT y no un puntero a un puntero CERT_CONTEXT . Si una aplicación recibe ERROR_INTERNET_CLIENT_AUTH_CERT_NEEDED, debe llamar a InternetErrorDlg o usar InternetSetOption para proporcionar un certificado antes de volver a intentar la solicitud. A continuación, se llama a CertDuplicateCertificateContext para que la aplicación pueda liberar el contexto del certificado de forma independiente.

INTERNET_OPTION_CODEPAGE

68

De forma predeterminada, la parte host o autoridad de la dirección URL Unicode se codifica según la especificación de IDN. Al establecer esta opción en la solicitud o el identificador de conexión, cuando IDN está deshabilitado, se especifica un esquema de codificación de página de códigos para la parte host de la dirección URL. El parámetro lpBuffer de la llamada a InternetSetOption contiene la página de códigos DBCS deseada. Si no se especifica ninguna página de códigos en lpBuffer, WinINet usa la página de códigos del sistema predeterminada (CP_ACP). Nota: Esta opción se omite si IDN no está deshabilitada. Para obtener más información sobre cómo deshabilitar IDN, consulte la opción INTERNET_OPTION_IDN .

Windows XP con SP2 y Windows Server 2003 con SP1: Esta marca no se admite.

Versión: Requiere Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_PATH

100

De forma predeterminada, la parte de ruta de acceso de la dirección URL está codificada con UTF8. La API de WinINet realiza la codificación de caracteres de escape (%) en los caracteres de alto bits. Al establecer esta opción en la solicitud o el identificador de conexión, se deshabilita la codificación UTF8 y se establece una página de códigos específica. El parámetro lpBuffer de la llamada a InternetSetOption contiene la página de códigos DBCS deseada para la ruta de acceso. Si no se especifica ninguna página de códigos en lpBuffer, WinINet usa el CP_UTF8 predeterminado.

Windows XP con SP2 y Windows Server 2003 con SP1: Esta marca no se admite.

Versión: Requiere Internet Explorer 7.0.

INTERNET_OPTION_CODEPAGE_EXTRA

101

De forma predeterminada, la parte de ruta de acceso de la dirección URL es la página de códigos del sistema predeterminada (CP_ACP). Las conversiones de caracteres de escape (%) no se realizan en la parte adicional. Al establecer esta opción en la solicitud o el identificador de conexión, se deshabilita la codificación CP_ACP. El parámetro lpBuffer de la llamada a InternetSetOption contiene la página de códigos DBCS deseada para la parte adicional de la dirección URL. Si no se especifica ninguna página de códigos en lpBuffer, WinINet usa la página de códigos del sistema predeterminada (CP_ACP).

Windows XP con SP2 y Windows Server 2003 con SP1: Esta marca no se admite.

Versión: Requiere Internet Explorer 7.0.

INTERNET_OPTION_COMPRESSED_CONTENT_LENGTH

147

Para una solicitud en la que WinInet descomprimió la codificación de contenido proporcionada por el servidor, recupera la longitud de contenido notificada por el servidor del cuerpo de la respuesta como un ULONGLONG. Compatible con Windows 10, versión 1507 y posteriores.

INTERNET_OPTION_CONNECT_BACKOFF

4

Sin implementar.

INTERNET_OPTION_CONNECT_RETRIES

3

Establece o recupera un valor entero largo sin signo que contiene el número de veces que WinINet intenta resolver y conectarse a un host. Solo intenta una vez por dirección IP. Por ejemplo, si intenta conectarse a un host multiinicio que tiene diez direcciones IP y INTERNET_OPTION_CONNECT_RETRIES se establece en siete, WinINet solo intenta resolver y conectarse a las siete primeras direcciones IP. Por el contrario, dado el mismo conjunto de diez direcciones IP, si INTERNET_OPTION_CONNECT_RETRIES se establece en 20, WinINet intenta cada una de las diez solo una vez. Si un host tiene solo una dirección IP y se produce un error en el primer intento de conexión, no hay más intentos. Si se produce un error en un intento de conexión después del número especificado de intentos, se cancela la solicitud. El valor predeterminado de INTERNET_OPTION_CONNECT_RETRIES es cinco intentos. Esta opción se puede usar en cualquier identificador HINTERNET , incluido un identificador NULL . Lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONNECT_TIME

55

Sin implementar.

INTERNET_OPTION_CONNECT_TIMEOUT

2

Establece o recupera un valor entero largo sin signo que contiene el valor de tiempo de espera, en milisegundos, que se va a usar para las solicitudes de conexión a Internet. Al establecer esta opción en infinito (0xFFFFFFFF) se deshabilitará este temporizador.

Si una solicitud de conexión tarda más de este valor de tiempo de espera, se cancela la solicitud. Al intentar conectarse a varias direcciones IP para un único host (un host de inicio múltiple), el límite de tiempo de espera es acumulativo para todas las direcciones IP. Esta opción se puede usar en cualquier identificador HINTERNET , incluido un identificador NULL . Lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONNECTED_STATE

50

Establece o recupera un valor entero largo sin signo que contiene el estado conectado. Esto lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONTEXT_VALUE

45

Establece o recupera un DWORD_PTR que contiene la dirección del valor de contexto asociado a este identificador HINTERNET . Esta opción se puede usar en cualquier identificador HINTERNET . Esto lo usa InternetQueryOption e InternetSetOption. Anteriormente, establece el valor de contexto en la dirección almacenada en el puntero lpBuffer . Esto se ha corregido para que el valor almacenado en el búfer se use y a la marca de INTERNET_OPTION_CONTEXT_VALUE se le asigne un nuevo valor. El valor anterior, 10, se ha conservado para que las aplicaciones escritas para el comportamiento anterior sigan siendo compatibles.

INTERNET_OPTION_CONTROL_RECEIVE_TIMEOUT

6

Idéntico a INTERNET_OPTION_RECEIVE_TIMEOUT. Esto lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_CONTROL_SEND_TIMEOUT

5

Idéntico a INTERNET_OPTION_SEND_TIMEOUT. Esto lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_DATA_RECEIVE_TIMEOUT

8

Establece o recupera un valor entero largo sin signo que contiene el valor de tiempo de espera, en milisegundos, para recibir una respuesta a una solicitud para el canal de datos de una transacción FTP. Si la respuesta tarda más de este valor de tiempo de espera, se cancela la solicitud. Esta opción se puede usar en cualquier identificador HINTERNET , incluido un identificador NULL . Lo usa InternetQueryOption e InternetSetOption.

Esta marca no afecta a la funcionalidad HTTP.

INTERNET_OPTION_DATA_SEND_TIMEOUT

7

Establece o recupera un valor entero largo sin signo, en milisegundos, que contiene el valor de tiempo de espera para enviar una solicitud para el canal de datos de una transacción FTP. Si el envío tarda más de este valor de tiempo de espera, se cancela el envío. Esta opción se puede usar en cualquier identificador HINTERNET , incluido un identificador NULL . Lo usa InternetQueryOption e InternetSetOption.

Esta marca no afecta a la funcionalidad HTTP.

INTERNET_OPTION_DATAFILE_NAME

33

Recupera un valor de cadena que contiene el nombre del archivo que respalda una entidad descargada. Esta marca es válida después de que InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest se haya completado. InternetQueryOption solo puede consultar esta opción.

INTERNET_OPTION_DATAFILE_EXT

96

Establece un valor de cadena que contiene la extensión del archivo que respalda una entidad descargada. Esta marca debe establecerse antes de llamar a InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest. Esta opción solo se puede establecer mediante InternetSetOption.

INTERNET_OPTION_DIAGNOSTIC_SOCKET_INFO

67

Recupera una estructura de INTERNET_DIAGNOSTIC_SOCKET_INFO que contiene datos sobre una solicitud HTTP especificada. Esta marca la usa InternetQueryOption.

Windows 7: Esta opción ya no se admite.

INTERNET_OPTION_DIGEST_AUTH_UNLOAD

76

Hace que el sistema cierre la sesión del paquete de SSPI de autenticación implícita, purgando todas las credenciales creadas para el proceso. No se requiere ningún búfer para esta opción. Lo usa InternetSetOption.

INTERNET_OPTION_DISABLE_AUTODIAL

70

Sin implementar.

INTERNET_OPTION_DISCONNECTED_TIMEOUT

49

Sin implementar.

INTERNET_OPTION_ENABLE_HTTP_PROTOCOL

148

Establece una máscara de bits DWORD de versiones HTTP avanzadas aceptables. Se puede establecer en cualquier tipo de identificador. Los valores posibles son:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Compatible con Windows 10, versión 1507 y posteriores.

Las versiones heredadas de HTTP (1.1 y anteriores) no se pueden deshabilitar con esta opción. El valor predeterminado es 0x0. Compatible con Windows 10, versión 1507 y posteriores.

INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ

122

En un identificador de solicitud, establece un control booleano que indica si se devolverán redireccionamientos desde la memoria caché de WinInet para una solicitud determinada. El valor predeterminado es FALSE. Se admite en Windows 8 y versiones posteriores.

INTERNET_OPTION_ENCODE_EXTRA

155

Obtiene o establece un BOOL que indica si los caracteres no ASCII de la cadena de consulta deben estar codificados por porcentaje. El valor predeterminado es FALSE. Se admite en Windows 8.1 y versiones posteriores.

INTERNET_OPTION_END_BROWSER_SESSION

42

Vacía las entradas que no están en uso de la memoria caché de contraseñas en la unidad de disco duro. También restablece el tiempo de caché usado cuando el modo de sincronización es una vez por sesión. No se requiere ningún búfer para esta opción. Esto lo usa InternetSetOption.

INTERNET_OPTION_ERROR_MASK

62

Establece un valor entero largo sin signo que contiene las máscaras de error que la aplicación cliente puede controlar. Puede ser una combinación de los siguientes valores:

INTERNET_ERROR_MASK_COMBINED_SEC_CERT

0x2

Indica que se notificarán todos los errores de certificado mediante la misma devolución de error, es decir, ERROR_INTERNET_SEC_CERT_ERRORS. Si se establece esta marca, llame a InternetErrorDlg al recibir el error de ERROR_INTERNET_SEC_CERT_ERRORS para que el usuario pueda responder a un cuadro de diálogo conocido que describa el problema.

Precaución

No se puede informar al usuario de este error que expone al usuario a posibles ataques de suplantación de identidad.

INTERNET_ERROR_MASK_INSERT_CDROM

0x1

Indica que la aplicación cliente puede controlar el código de error ERROR_INTERNET_INSERT_CDROM .

INTERNET_ERROR_MASK_LOGIN_FAILURE_DISPLAY_ENTITY_BODY

0x8

Indica que la aplicación cliente puede controlar el código de error ERROR_INTERNET_LOGIN_FAILURE_DISPLAY_ENTITY_BODY .

INTERNET_ERROR_MASK_NEED_MSN_SSPI_PKG

0x4

Sin implementar.

INTERNET_OPTION_ENTERPRISE_CONTEXT

159

Establece un PWSTR que contiene el identificador de empresa (consulte https://msdn.microsoft.com/library/windows/desktop/mt759320(v=vs.85).aspx) que se aplica a la solicitud. Compatible con Windows 10, versión 1507 y posteriores.

INTERNET_OPTION_EXTENDED_ERROR

24

Recupera un valor entero largo sin signo que contiene un código de error winsock asignado al ERROR_INTERNET_ mensajes de error devueltos por última vez en este contexto de subproceso. Esta opción se usa en un identificador HINTERNETNULL por InternetQueryOption.

INTERNET_OPTION_FROM_CACHE_TIMEOUT

63

Establece o recupera un valor entero largo sin signo de a1n que contiene la cantidad de tiempo que el sistema debe esperar una respuesta a una solicitud de red antes de comprobar la memoria caché de una copia del recurso. Si una solicitud de red tarda más tiempo que el tiempo especificado y el recurso solicitado está disponible en la memoria caché, el recurso se recupera de la memoria caché. Esto lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_HANDLE_TYPE

9

Recupera un valor entero largo sin signo que contiene el tipo de identificadores HINTERNET pasados. Esto lo usa InternetQueryOption en cualquier identificador HINTERNET . Entre los valores devueltos posibles se incluyen los siguientes.

INTERNET_HANDLE_TYPE_CONNECT_FTP

2

INTERNET_HANDLE_TYPE_CONNECT_GOPHER

3

INTERNET_HANDLE_TYPE_CONNECT_HTTP

4

INTERNET_HANDLE_TYPE_FILE_REQUEST

14

INTERNET_HANDLE_TYPE_FTP_FILE

7

INTERNET_HANDLE_TYPE_FTP_FILE_HTML

8

INTERNET_HANDLE_TYPE_FTP_FIND

5

INTERNET_HANDLE_TYPE_FTP_FIND_HTML

6

INTERNET_HANDLE_TYPE_GOPHER_FILE

11

INTERNET_HANDLE_TYPE_GOPHER_FILE_HTML

12

INTERNET_HANDLE_TYPE_GOPHER_FIND

9

INTERNET_HANDLE_TYPE_GOPHER_FIND_HTML

10

INTERNET_HANDLE_TYPE_HTTP_REQUEST

13

INTERNET_HANDLE_TYPE_INTERNET

1

INTERNET_OPTION_HSTS

157

Obtiene o establece un BOOL que indica si WinInet debe seguir las directivas HTTP Strict Transport Security (HSTS) de los servidores. Si está habilitada, https:// solicitudes esquemadas a dominios que tienen una directiva HSTS almacenada en caché por WinInet se redirigirá a las direcciones URL de https:// coincidentes. El valor predeterminado es FALSE. Se admite en Windows 8.1 y versiones posteriores.

INTERNET_OPTION_HTTP_DECODING

65

Permite que WinINet realice la descodificación para los esquemas de codificación gzip y deflate. Para obtener más información, vea Codificación de contenido.

INTERNET_OPTION_HTTP_PROTOCOL_USED

149

Obtiene un DWORD que indica qué versión HTTP avanzada se usó en una solicitud determinada. Los valores posibles son:

• HTTP_PROTOCOL_FLAG_HTTP2 (0x2). Compatible con Windows 10, versión 1507 y posteriores.

0x0 indica HTTP/1.1 o versiones anteriores; consulte INTERNET_OPTION_HTTP_VERSION si se necesita más precisión sobre qué versión heredada se usó. Compatible con Windows 10, versión 1507 y posteriores.

INTERNET_OPTION_HTTP_VERSION

59

Establece o recupera una estructura de HTTP_VERSION_INFO que contiene la versión HTTP admitida. Debe usarse en un identificador NULL . Esto lo usa InternetQueryOption e InternetSetOption.

En Windows 7, Windows Server 2008 R2 y versiones posteriores, la configuración de Internet Explorer invalida el valor del miembro dwMinorVersion en la estructura de HTTP_VERSION_INFO . EnableHttp1_1 es un valor del Registro en HKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE controlado por Opciones de Internet establecidas en Internet Explorer para el sistema. El valor de EnableHttp1_1 tiene como valor predeterminado 1. La estructura de HTTP_VERSION_INFO se omite para cualquier versión HTTP inferior a 1.1 si EnableHttp1_1 está establecida en 1.

INTERNET_OPTION_IDENTITY

78

Sin implementar.

INTERNET_OPTION_IDLE_STATE

51

Sin implementar.

INTERNET_OPTION_IDN

102

De forma predeterminada, la parte host o autoridad de la dirección URL se codifica según la especificación de IDN para las conexiones directas y de proxy. Esta opción se puede usar en la solicitud o en el identificador de conexión para habilitar o deshabilitar IDN. Cuando IDN está deshabilitado, WinINet usa la página de códigos del sistema para codificar la parte host o autoridad de la dirección URL. Para deshabilitar la conversión de host IDN, establezca el parámetro lpBuffer en la llamada a InternetSetOption en cero. Para habilitar la conversión de IDN solo en la conexión directa, especifique INTERNET_FLAG_IDN_DIRECT en el parámetro lpBuffer en la llamada a InternetSetOption. Para habilitar la conversión de IDN solo en la conexión de proxy, especifique INTERNET_FLAG_IDN_PROXY en el parámetro lpBuffer en la llamada a InternetSetOption.

Windows XP con SP2 y Windows Server 2003 con SP1: Esta marca no se admite.

Versión: Requiere Internet Explorer 7.0.

INTERNET_OPTION_IGNORE_OFFLINE

77

Establece o recupera si se debe omitir la marca sin conexión global para el identificador de solicitud especificado. No se requiere ningún búfer para esta opción. Esto lo usa InternetQueryOption e InternetSetOption con un identificador de solicitud. Esta opción solo es válida en Internet Explorer 5 y versiones posteriores.

INTERNET_OPTION_KEEP_CONNECTION

22

Sin implementar.

INTERNET_OPTION_LISTEN_TIMEOUT

11

Sin implementar.

INTERNET_OPTION_MAX_CONNS_PER_1_0_SERVER

74

Establece o recupera un valor entero largo sin signo que contiene el número máximo de conexiones permitidas por servidor HTTP/1.0. Esto lo usa InternetQueryOption e InternetSetOption. Esta opción solo es válida en Internet Explorer 5 y versiones posteriores.

INTERNET_OPTION_MAX_CONNS_PER_PROXY

103

Establece o recupera un valor entero largo sin signo que contiene el número máximo de conexiones permitidas por proxy CERN. Cuando se establece o recupera esta opción, el parámetro hInternet debe establecerse en un valor de identificador nulo . Un valor de identificador NULL indica que la opción debe establecerse o consultarse para el proceso actual. Al llamar a InternetSetOption con esta opción, todos los objetos proxy existentes recibirán el nuevo valor. Este valor se limita a un intervalo de 2 a 128, ambos incluidos.

Versión: Requiere Internet Explorer 8.0.

INTERNET_OPTION_MAX_CONNS_PER_SERVER

73

Establece o recupera un valor entero largo sin signo que contiene el número máximo de conexiones permitidas por servidor. Esto lo usa InternetQueryOption e InternetSetOption. Esta opción solo es válida en Internet Explorer 5 y versiones posteriores.

INTERNET_OPTION_OFFLINE_MODE

26

Sin implementar.

INTERNET_OPTION_OFFLINE_SEMANTICS

52

Sin implementar.

INTERNET_OPTION_OPT_IN_WEAK_SIGNATURE

176

Opte por firmas débiles (por ejemplo, SHA-1) que se tratarán como inseguros. Esto indicará a WinInet que llame a CertGetCertificateChain mediante el parámetro CERT_CHAIN_OPT_IN_WEAK_SIGNATURE .

INTERNET_OPTION_PARENT_HANDLE

21

Recupera el identificador primario de este identificador. Esta opción se puede usar en cualquier controlador HINTERNET por InternetQueryOption.

INTERNET_OPTION_PASSWORD

29

Establece o recupera un valor de cadena que contiene la contraseña asociada a un identificador devuelto por InternetConnect. Esto lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_PER_CONNECTION_OPTION

75

Establece o recupera una estructura de INTERNET_PER_CONN_OPTION_LIST que especifica una lista de opciones para una conexión determinada. Esto lo usa InternetQueryOption e InternetSetOption. Esta opción solo es válida en Internet Explorer 5 y versiones posteriores.

Nota

INTERNET_OPTION_PER_CONNECTION_OPTION hace que la configuración se cambie en todo el sistema cuando se usa un identificador NULL en la llamada a InternetSetOption. Para actualizar la configuración global del proxy, debe llamar a InternetSetOption con la marca de opción INTERNET_OPTION_REFRESH .

Nota

Para cambiar la información de proxy para todo el proceso sin afectar a la configuración global en Internet Explorer 5 y versiones posteriores, use esta opción en el identificador que se devuelve de InternetOpen. En el ejemplo de código siguiente se cambia el proxy para todo el proceso, aunque el identificador HINTERNET esté cerrado y no lo usen las solicitudes.

INTERNET_OPTION_POLICY

48

Sin implementar.

INTERNET_OPTION_PROXY

38

Establece o recupera una estructura de INTERNET_PROXY_INFO que contiene los datos de proxy de un identificador InternetOpen existente cuando el identificador HINTERNET no es NULL. Si el identificador HINTERNET es NULL, la función establece o consulta los datos de proxy globales. Esta opción se puede usar en el identificador devuelto por InternetOpen. Lo usa InternetQueryOption e InternetSetOption.

Nota

Se recomienda usar INTERNET_OPTION_PER_CONNECTION_OPTION en lugar de INTERNET_OPTION_PROXY.

INTERNET_OPTION_PROXY_PASSWORD

44

Establece o recupera un valor de cadena que contiene la contraseña usada para acceder al proxy. Esto lo usa InternetQueryOption e InternetSetOption. Esta opción se puede establecer en el identificador devuelto por InternetConnect o HttpOpenRequest.

INTERNET_OPTION_PROXY_SETTINGS_CHANGED

95

Alerta a la instancia actual de WinInet que ha cambiado la configuración del proxy y que deben actualizarse con la nueva configuración. Para alertar a todas las instancias de WinInet disponibles, establezca el parámetro Buffer de InternetSetOption en NULL y BufferLength en 0 al pasar esta opción. Esta opción se puede establecer en el identificador devuelto por InternetConnect o HttpOpenRequest.

INTERNET_OPTION_PROXY_USERNAME

43

Establece o recupera un valor de cadena que contiene el nombre de usuario usado para acceder al proxy. Esto lo usa InternetQueryOption e InternetSetOption. Esta opción se puede establecer en el identificador devuelto por InternetConnect o HttpOpenRequest.

INTERNET_OPTION_READ_BUFFER_SIZE

12

Establece o recupera un valor entero largo sin signo que contiene el tamaño del búfer de lectura. Esta opción se puede usar en los identificadores HINTERNET devueltos por FtpOpenFile, FtpFindFirstFile e InternetConnect (solo sesión FTP). Esta opción la usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_RECEIVE_THROUGHPUT

57

Sin implementar.

INTERNET_OPTION_RECEIVE_TIMEOUT

6

Establece o recupera un valor entero largo sin signo que contiene el valor de tiempo de espera, en milisegundos, para recibir una respuesta a una solicitud. Si la respuesta tarda más de este valor de tiempo de espera, se cancela la solicitud. Esta opción se puede usar en cualquier identificador HINTERNET , incluido un identificador NULL . Lo usa InternetQueryOption e InternetSetOption.

Esta opción no está pensada para representar un tiempo de espera inmediato específico. Puede esperar que el tiempo de espera se produzca hasta seis segundos después del valor de tiempo de espera establecido.

Cuando se usa en referencia a una transacción FTP, esta opción hace referencia al canal de control.

INTERNET_OPTION_REFRESH

37

Hace que los datos de proxy se vuelvan a leer del Registro para un identificador. No se requiere ningún búfer. Esta opción se puede usar en el identificador HINTERNET devuelto por InternetOpen. Lo usa InternetSetOption.

INTERNET_OPTION_REMOVE_IDENTITY

79

Sin implementar.

INTERNET_OPTION_REQUEST_FLAGS

23

Recupera un valor entero largo sin signo que contiene las marcas de estado especiales que indican el estado de la descarga en curso. Esto lo usa InternetQueryOption. La opción INTERNET_OPTION_REQUEST_FLAGS puede ser uno de los siguientes valores:

INTERNET_REQFLAG_ASYNC

0x00000002

Sin implementar.

INTERNET_REQFLAG_CACHE_WRITE_DISABLED

0x00000040

No se puede almacenar en caché la solicitud de Internet (por ejemplo, una solicitud HTTPS).

INTERNET_REQFLAG_FROM_CACHE

0x00000001

La respuesta procede de la memoria caché.

INTERNET_REQFLAG_NET_TIMEOUT

0x00000080

Se agota el tiempo de espera de la solicitud de Internet.

INTERNET_REQFLAG_NO_HEADERS

0x00000008

La respuesta original no contenía encabezados.

INTERNET_REQFLAG_PASSIVE

0x00000010

Sin implementar.

INTERNET_REQFLAG_VIA_PROXY

0x00000004

La solicitud se realizó a través de un proxy.

INTERNET_OPTION_REQUEST_PRIORITY

58

Establece o recupera un valor entero largo sin signo que contiene la prioridad de las solicitudes que compiten por una conexión en un identificador HTTP. Lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_RESET_URLCACHE_SESSION

60

Inicia una nueva sesión de caché para el proceso. No se requiere ningún búfer. Esto lo usa InternetSetOption. Esta opción solo está reservada para uso interno.

INTERNET_OPTION_SECONDARY_CACHE_KEY

53

Establece o recupera un valor de cadena que contiene la clave de caché secundaria. Lo usa InternetQueryOption e InternetSetOption. Esta opción solo está reservada para uso interno.

INTERNET_OPTION_SECURITY_CERTIFICATE

35

Recupera el certificado de un servidor SSL/PCT (Capa de sockets seguros/Tecnología de comunicaciones privadas) en una cadena con formato. Esto lo usa InternetQueryOption.

INTERNET_OPTION_SECURITY_CERTIFICATE_STRUCT

32

Recupera el certificado de un servidor SSL/PCT en la estructura INTERNET_CERTIFICATE_INFO. Esto lo usa InternetQueryOption.

INTERNET_OPTION_SECURITY_FLAGS

31

Recupera un valor entero largo sin signo que contiene las marcas de seguridad de un identificador. InternetQueryOption usa esta opción. Puede ser una combinación de los valores siguientes.

SECURITY_FLAG_128BIT

0x20000000

Idéntico al valor preferido SECURITY_FLAG_STRENGTH_STRONG. Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_40BIT

0x10000000

Idéntico al valor preferido SECURITY_FLAG_STRENGTH_WEAK. Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_56BIT

0x40000000

Idéntico al valor preferido SECURITY_FLAG_STRENGTH_MEDIUM. Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_FORTEZZA

0x08000000

Indica que Fortezza se ha usado para proporcionar confidencialidad, autenticación o integridad para la conexión especificada.

SECURITY_FLAG_IETFSSL4

0x00000020

Sin implementar.

SECURITY_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Omite el mensaje de error ERROR_INTERNET_SEC_CERT_CN_INVALID .

SECURITY_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Omite el mensaje de error ERROR_INTERNET_SEC_CERT_DATE_INVALID .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Omite el mensaje de error ERROR_INTERNET_HTTPS_TO_HTTP_ON_REDIR .

SECURITY_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Omite el mensaje de error ERROR_INTERNET_HTTP_TO_HTTPS_ON_REDIR .

SECURITY_FLAG_IGNORE_REVOCATION

0x00000080

Omite los problemas de revocación de certificados.

SECURITY_FLAG_IGNORE_UNKNOWN_CA

0x00000100

Omite los problemas desconocidos de la entidad de certificación.

SECURITY_FLAG_IGNORE_WEAK_SIGNATURE

0x00010000

Omite los problemas de firma de certificado débil.

SECURITY_FLAG_IGNORE_WRONG_USAGE

0x00000200

Omite los problemas de uso incorrectos.

SECURITY_FLAG_NORMALBITNESS

0x10000000

Idéntico al valor SECURITY_FLAG_STRENGTH_WEAK. Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_PCT

0x00000008

Sin implementar.

SECURITY_FLAG_PCT4

0x00000010

Sin implementar.

SECURITY_FLAG_SECURE

0x00000001

Usa transferencias seguras. Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_SSL

0x00000002

Sin implementar.

SECURITY_FLAG_SSL3

0x00000004

Sin implementar.

SECURITY_FLAG_STRENGTH_MEDIUM

0x40000000

Usa cifrado mediano (56 bits). Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_STRENGTH_STRONG

0x20000000

Usa cifrado seguro (de 128 bits). Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_STRENGTH_WEAK

0x10000000

Usa cifrado débil (40 bits). Esto solo se devuelve en una llamada a InternetQueryOption.

SECURITY_FLAG_UNKNOWNBIT

0x80000000

El tamaño de bits usado en el cifrado es desconocido. Esto solo se devuelve en una llamada a InternetQueryOption.

Tenga en cuenta que los datos recuperados de esta manera se relacionan con una transacción que se ha producido, cuyo nivel de seguridad ya no se puede cambiar.

INTERNET_OPTION_SECURITY_KEY_BITNESS

36

Recupera un valor entero largo sin signo que contiene el tamaño de bits de la clave de cifrado. Cuanto mayor sea el número, mayor será la intensidad del cifrado utilizada. Esto lo usa InternetQueryOption. Tenga en cuenta que los datos recuperados de esta manera se relacionan con una transacción que ya se ha producido, cuyo nivel de seguridad ya no se puede cambiar.

INTERNET_OPTION_SEND_THROUGHPUT

56

Sin implementar.

INTERNET_OPTION_SEND_TIMEOUT

5

Establece o recupera un valor entero largo sin signo, en milisegundos, que contiene el valor de tiempo de espera para enviar una solicitud. Si el envío tarda más de este valor de tiempo de espera, se cancela el envío. Esta opción se puede usar en cualquier identificador HINTERNET , incluido un identificador NULL . Lo usa InternetQueryOption e InternetSetOption.

Cuando se usa en referencia a una transacción FTP, esta opción hace referencia al canal de control.

INTERNET_OPTION_SERVER_CERT_CHAIN_CONTEXT

105

Recupera el contexto de cadena de certificados del servidor como un PCCERT_CHAIN_CONTEXT duplicado. Puede pasar este contexto duplicado a cualquier función de Crypto API que tome un PCCERT_CHAIN_CONTEXT. Debe llamar a CertFreeCertificateChain en el PCCERT_CHAIN_CONTEXT devuelto cuando haya terminado con el contexto de la cadena de certificados.

Versión: Requiere Internet Explorer 8.0.

INTERNET_OPTION_SETTINGS_CHANGED

39

Notifica al sistema que se ha cambiado la configuración del Registro para que compruebe la configuración en la siguiente llamada a InternetConnect. Esto lo usa InternetSetOption.

INTERNET_OPTION_SUPPRESS_SERVER_AUTH

104

Establece un objeto de solicitud HTTP de modo que no inicie sesión en los servidores de origen, pero realizará el inicio de sesión automático en servidores proxy HTTP. Esta opción difiere de la marca solicitud INTERNET_FLAG_NO_AUTH, lo que impide la autenticación tanto en servidores proxy como en servidores de origen.

Al establecer este modo, se suprimirá el uso de cualquier material de credenciales (ya sea el nombre de usuario o la contraseña proporcionados anteriormente o el certificado SSL de cliente) al comunicarse con un servidor de origen. Sin embargo, si la solicitud debe transitar a través de un proxy de autenticación, WinINet seguirá realizando la autenticación automática en el proxy HTTP según la configuración de zona de intranet para el usuario. La configuración predeterminada zona de intranet es permitir el inicio de sesión automático mediante las credenciales predeterminadas del usuario.

Para garantizar la supresión de toda la información de identificación, el autor de la llamada debe combinar INTERNET_OPTION_SUPPRESS_SERVER_AUTH con la marca de solicitud INTERNET_FLAG_NO_COOKIES .

Esta opción solo se puede establecer en objetos de solicitud antes de que se hayan enviado. Los intentos de establecer esta opción después de enviar la solicitud devolverán ERROR_INTERNET_INCORRECT_HANDLE_STATE.

No se requiere ningún búfer para esta opción. Esto lo usa InternetSetOption solo en los identificadores devueltos por HttpOpenRequest .

Versión: Requiere Internet Explorer 8.0 o posterior.

INTERNET_OPTION_SUPPRESS_BEHAVIOR

81

Una opción de uso general que se usa para suprimir comportamientos en todo el proceso. El parámetro lpBuffer de la función debe ser un puntero a un DWORD que contenga el comportamiento específico que se va a suprimir. Esta opción no se puede consultar con InternetQueryOption. Los valores permitidos son:

INTERNET_SUPPRESS_RESET_ALL

0

Deshabilita todas las supresiones, vuelve a habilitar el comportamiento predeterminado y configurado. Esta opción es equivalente a establecer INTERNET_SUPPRESS_COOKIE_POLICY_RESET y INTERNET_SUPPRESS_COOKIE_PERSIST_RESET individualmente.

Versión: Requiere Internet Explorer 6.0 o posterior.

INTERNET_SUPPRESS_COOKIE_POLICY

1

Omite las directivas de cookies configuradas y permite establecer las cookies.

Versión: Requiere Internet Explorer 6.0 o posterior.

INTERNET_SUPPRESS_COOKIE_POLICY_RESET

2

Deshabilita la supresión de INTERNET_SUPPRESS_COOKIE_POLICY , lo que permite la evaluación de cookies según la directiva de cookies configurada.

Versión: Requiere Internet Explorer 6.0 o posterior.

INTERNET_SUPPRESS_COOKIE_PERSIST

3

Suprime la persistencia de las cookies, incluso si el servidor los ha especificado como persistentes.

Versión: Requiere Internet Explorer 8.0 o posterior.

INTERNET_SUPPRESS_COOKIE_PERSIST_RESET

4

Deshabilita la supresión de INTERNET_SUPPRESS_COOKIE_PERSIST y vuelve a habilitar la persistencia de las cookies. Las cookies suprimidas anteriormente no serán persistentes.

Versión: Requiere Internet Explorer 8.0 o posterior.

INTERNET_OPTION_URL

34

Recupera un valor de cadena que contiene la dirección URL completa de un recurso descargado. Si la dirección URL original contenía datos adicionales, como cadenas de búsqueda o delimitadores, o si la llamada se redirigió, la dirección URL devuelta difiere del original. Esta opción es válida en los identificadores HINTERNET devueltos por InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest. Lo usa InternetQueryOption.

INTERNET_OPTION_USER_AGENT

41

Establece o recupera la cadena del agente de usuario en los identificadores proporcionados por InternetOpen y usados en las funciones HttpSendRequest posteriores, siempre y cuando no se invalide mediante un encabezado agregado por HttpAddRequestHeaders o HttpSendRequest. Lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_USERNAME

28

Establece o recupera una cadena que contiene el nombre de usuario asociado a un identificador devuelto por InternetConnect. Lo usa InternetQueryOption e InternetSetOption.

INTERNET_OPTION_VERSION

40

Recupera una estructura de INTERNET_VERSION_INFO que contiene el número de versión de Wininet.dll. Esta opción se puede usar en un identificador NULL HINTERNET mediante InternetQueryOption.

INTERNET_OPTION_WRITE_BUFFER_SIZE

13

Establece o recupera un valor entero largo sin signo que contiene el tamaño, en bytes, del búfer de escritura. Esta opción se puede usar en los identificadores HINTERNET devueltos por FtpOpenFile e InternetConnect (solo sesión FTP). Lo usa InternetQueryOption e InternetSetOption.

Observaciones

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).

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; Winineti.h