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