Marcas de API

Muchas de las funciones winINet aceptan una matriz de marcas como parámetro. A continuación se muestra una breve descripción de las marcas definidas.

INTERNET_COOKIE_EVALUATE_P3P

0x80

Indica que se va a asociar un encabezado platform for Privacy Protection (P3P) a una cookie.

INTERNET_COOKIE_THIRD_PARTY

0x10

Indica que se está configurando o recuperando una cookie de terceros.

INTERNET_FLAG_ASYNC

0x10000000

Realiza solo solicitudes asincrónicas en identificadores descendientes del identificador devuelto de esta función. Solo la función InternetOpen usa esta marca.

INTERNET_FLAG_CACHE_ASYNC

0x00000080

Permite una escritura diferida de caché.

INTERNET_FLAG_CACHE_IF_NET_FAIL

0x00010000

Devuelve el recurso de la memoria caché si se produce un error en la solicitud de red para el recurso debido a un error de ERROR_INTERNET_CONNECTION_RESET o ERROR_INTERNET_CANNOT_CONNECT . HttpOpenRequest usa esta marca.

INTERNET_FLAG_DONT_CACHE

0x04000000

No agrega la entidad devuelta a la memoria caché. Esto es idéntico al valor preferido, INTERNET_FLAG_NO_CACHE_WRITE.

INTERNET_FLAG_EXISTING_CONNECT

0x20000000

Intenta usar un objeto InternetConnect existente si existe con los mismos atributos necesarios para realizar la solicitud. Esto solo es útil con operaciones FTP, ya que FTP es el único protocolo que normalmente realiza varias operaciones durante la misma sesión. WinINet almacena en caché un único identificador de conexión para cada identificador HINTERNET generado por InternetOpen. Las funciones InternetOpenUrl e InternetConnect usan esta marca para las conexiones Http y Ftp.

INTERNET_FLAG_FORMS_SUBMIT

0x00000040

Indica que se trata de un envío de formularios.

INTERNET_FLAG_FROM_CACHE

0x01000000

No realiza solicitudes de red. Todas las entidades se devuelven de la memoria caché. Si el elemento solicitado no está en la memoria caché, se devuelve un error adecuado, como ERROR_FILE_NOT_FOUND. Solo la función InternetOpen usa esta marca.

INTERNET_FLAG_FWD_BACK

0x00000020

Indica que la función debe usar la copia del recurso que se encuentra actualmente en la memoria caché de Internet. No se comprueba la fecha de expiración y otra información sobre el recurso. Si el elemento solicitado no se encuentra en la memoria caché de Internet, el sistema intenta localizar el recurso en la red. Este valor se introdujo en Microsoft Internet Explorer 5 y está asociado a las operaciones de botón Reenviar y Atrás de Internet Explorer.

INTERNET_FLAG_HYPERLINK

0x00000400

Fuerza una recarga si no hay ninguna hora de expiración y no se devuelve la hora LastModified del servidor al determinar si se debe volver a cargar el elemento desde la red. Esta marca se puede usar mediante FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP y Windows Server 2003 R2 y versiones anteriores: También se usa en GopherFindFirstFile y GopherOpenFile.

INTERNET_FLAG_IGNORE_CERT_CN_INVALID

0x00001000

Deshabilita la comprobación de certificados basados en SSL/PCT que se devuelven desde el servidor con el nombre de host especificado en la solicitud. WinINet usa una comprobación sencilla de los certificados comparando los nombres de host coincidentes y las reglas de caracteres comodín simples. HttpOpenRequest e InternetOpenUrl pueden usar esta marca (para solicitudes HTTP).

INTERNET_FLAG_IGNORE_CERT_DATE_INVALID

0x00002000

Deshabilita la comprobación de certificados basados en SSL/PCT para las fechas de validez adecuadas. HttpOpenRequest e InternetOpenUrl pueden usar esta marca (para solicitudes HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP

0x00008000

Deshabilita la detección de este tipo especial de redirección. Cuando se usa esta marca, WinINet permite de forma transparente las redirecciones de HTTPS a direcciones URL HTTP. HttpOpenRequest e InternetOpenUrl pueden usar esta marca (para solicitudes HTTP).

INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS

0x00004000

Deshabilita la detección de este tipo especial de redirección. Cuando se usa esta marca, WinINet permite de forma transparente las redirecciones de HTTP a direcciones URL HTTPS. HttpOpenRequest e InternetOpenUrl pueden usar esta marca (para solicitudes HTTP).

INTERNET_FLAG_KEEP_CONNECTION

0x00400000

Usa la semántica de mantenimiento activo, si está disponible, para la conexión. Esta marca la usa HttpOpenRequest e InternetOpenUrl (para solicitudes HTTP). Esta marca es necesaria para Microsoft Network (MSN), NTLM y otros tipos de autenticación.

INTERNET_FLAG_MAKE_PERSISTENT

0x02000000

Ya no se admite.

INTERNET_FLAG_MUST_CACHE_REQUEST

0x00000010

Idéntico al valor preferido, INTERNET_FLAG_NEED_FILE. Hace que se cree un archivo temporal si el archivo no se puede almacenar en caché. Esta marca se puede usar mediante FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP y Windows Server 2003 R2 y versiones anteriores: También se usa en GopherFindFirstFile y GopherOpenFile.

INTERNET_FLAG_NEED_FILE

0x00000010

Hace que se cree un archivo temporal si el archivo no se puede almacenar en caché. Esta marca se puede usar mediante FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP y Windows Server 2003 R2 y versiones anteriores: También se usa en GopherFindFirstFile y GopherOpenFile.

INTERNET_FLAG_NO_AUTH

0x00040000

No intenta la autenticación automáticamente. HttpOpenRequest e InternetOpenUrl pueden usar esta marca (para solicitudes HTTP).

INTERNET_FLAG_NO_AUTO_REDIRECT

0x00200000

No controla automáticamente el redireccionamiento en HttpSendRequest. Esta marca también se puede usar en InternetOpenUrl para las solicitudes HTTP.

INTERNET_FLAG_NO_CACHE_WRITE

0x04000000

No agrega la entidad devuelta a la memoria caché. Esta marca la usa , HttpOpenRequest e InternetOpenUrl.

Windows XP y Windows Server 2003 R2 y versiones anteriores: También se usa en GopherFindFirstFile y GopherOpenFile.

INTERNET_FLAG_NO_COOKIES

0x00080000

No agrega automáticamente encabezados de cookies a las solicitudes y no agrega automáticamente cookies devueltas a la base de datos de cookies. HttpOpenRequest e InternetOpenUrl pueden usar esta marca (para solicitudes HTTP).

INTERNET_FLAG_NO_UI

0x00000200

Deshabilita el cuadro de diálogo cookie. HttpOpenRequest e InternetOpenUrl pueden usar esta marca (solo solicitudes HTTP).

INTERNET_FLAG_OFFLINE

0x01000000

Idéntico a INTERNET_FLAG_FROM_CACHE. No realiza solicitudes de red. Todas las entidades se devuelven de la memoria caché. Si el elemento solicitado no está en la memoria caché, se devuelve un error adecuado, como ERROR_FILE_NOT_FOUND. Solo la función InternetOpen usa esta marca.

INTERNET_FLAG_PASSIVE

0x08000000

Usa la semántica de FTP pasivo. Solo InternetConnect e InternetOpenUrl usan esta marca. InternetConnect usa esta marca para las solicitudes FTP y InternetOpenUrl usa esta marca para los archivos y directorios FTP.

INTERNET_FLAG_PRAGMA_NOCACHE

0x00000100

Obliga a que el servidor de origen resuelva la solicitud, incluso si existe una copia almacenada en caché en el proxy. La función InternetOpenUrl (solo en solicitudes HTTP y HTTPS) y la función HttpOpenRequest usan esta marca.

INTERNET_FLAG_RAW_DATA

0x40000000

Devuelve los datos como una estructura de WIN32_FIND_DATA al recuperar información del directorio FTP. Si no se especifica esta marca o si la llamada se realiza a través de un proxy CERN, InternetOpenUrl devuelve la versión HTML del directorio. Solo la función InternetOpenUrl usa esta marca.

Windows XP y Windows Server 2003 R2 y versiones anteriores: También devuelve una estructura de GOPHER_FIND_DATA al recuperar información de directorio de Gopher.

INTERNET_FLAG_READ_PREFETCH

0x00100000

Esta marca está deshabilitada actualmente.

INTERNET_FLAG_RELOAD

0x80000000

Fuerza una descarga del archivo, el objeto o el listado de directorio solicitado del servidor de origen, no de la memoria caché. Las funciones FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl usan esta marca.

Windows XP y Windows Server 2003 R2 y versiones anteriores: También se usa en GopherFindFirstFile y GopherOpenFile.

INTERNET_FLAG_RESTRICTED_ZONE

0x00020000

Indica que la cookie que se establece está asociada a un sitio que no es de confianza.

INTERNET_FLAG_RESYNCHRONIZE

0x00000800

Vuelve a cargar los recursos HTTP si el recurso se ha modificado desde la última vez que se descargó. Se vuelven a cargar todos los recursos FTP. Esta marca se puede usar mediante FtpFindFirstFile, FtpGetFile, FtpOpenFile, FtpPutFile, HttpOpenRequest e InternetOpenUrl.

Windows XP y Windows Server 2003 R2 y versiones anteriores: También se usan en GopherFindFirstFile y GopherOpenFile, y se vuelven a cargar los recursos de Gopher.

INTERNET_FLAG_SECURE

0x00800000

Usa semántica de transacción segura. Esto se traduce en el uso de capa de sockets seguros/tecnología de comunicaciones privadas (SSL/PCT) y solo es significativo en las solicitudes HTTP. HttpOpenRequest e InternetOpenUrl usan esta marca, pero esto es redundante si https:// aparece en la dirección URL. La función InternetConnect usa esta marca para las conexiones HTTP; todos los identificadores de solicitud creados en esta conexión heredarán esta marca.

INTERNET_FLAG_TRANSFER_ASCII

0x00000001

Transfiere el archivo como ASCII (solo FTP). FtpOpenFile, FtpGetFile y FtpPutFile pueden usar esta marca.

INTERNET_FLAG_TRANSFER_BINARY

0x00000002

Transfiere el archivo como binario (solo FTP). FtpOpenFile, FtpGetFile y FtpPutFile pueden usar esta marca.

INTERNET_NO_CALLBACK

0x00000000

Indica que no se deben realizar devoluciones de llamada para esa API. Se usa para el parámetro dxContext de las funciones que permiten operaciones asincrónicas.

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.

WININET_API_FLAG_ASYNC

0x00000001

Fuerza las operaciones asincrónicas.

WININET_API_FLAG_SYNC

0x00000004

Fuerza las operaciones sincrónicas.

WININET_API_FLAG_USE_CONTEXT

0x00000008

Obliga a la API a usar el valor de contexto, incluso si está establecido en cero.

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 los 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