Función CommitUrlCacheEntryW (wininet.h)
Almacena datos en el archivo especificado en la memoria caché de Internet y lo asocia a la dirección URL especificada.
Sintaxis
BOOL CommitUrlCacheEntryW(
[in] LPCWSTR lpszUrlName,
[in] LPCWSTR lpszLocalFileName,
[in] FILETIME ExpireTime,
[in] FILETIME LastModifiedTime,
[in] DWORD CacheEntryType,
[in] LPWSTR lpszHeaderInfo,
[in] DWORD cchHeaderInfo,
[in] LPCWSTR lpszFileExtension,
[in] LPCWSTR lpszOriginalUrl
);
Parámetros
[in] lpszUrlName
Puntero a una variable de cadena que contiene el nombre de origen de la entrada de caché. La cadena de nombre debe ser única y no debe contener ningún carácter de escape.
[in] lpszLocalFileName
Puntero a una variable de cadena que contiene el nombre del archivo local que se almacena en caché. Debe ser el mismo nombre que el devuelto por CreateUrlCacheEntryW.
[in] ExpireTime
Estructura FILETIME que contiene la fecha y hora de expiración (en la hora media de Greenwich) del archivo que se almacena en caché. Si se desconoce la fecha y hora de expiración, establezca este parámetro en cero.
[in] LastModifiedTime
Estructura FILETIME que contiene la fecha y hora de la última modificación (en la hora media de Greenwich) de la dirección URL que se almacena en caché. Si se desconoce la fecha y hora de la última modificación, establezca este parámetro en cero.
[in] CacheEntryType
Máscara de bits que indica el tipo de entrada de caché y sus propiedades. Los tipos de entrada de caché incluyen: entradas del historial (URLHISTORY_CACHE_ENTRY), entradas de cookies (COOKIE_CACHE_ENTRY) y contenido almacenado en caché normal (NORMAL_CACHE_ENTRY).
Este parámetro puede ser cero o más de las marcas de propiedad siguientes y las marcas de tipo de caché que se enumeran a continuación.
| Value | Significado |
|---|---|
|
Entrada de caché de cookies. |
|
Archivo de entrada de caché que se ha editado externamente. Este tipo de entrada de caché está exento del scavenging. |
|
Entrada de caché normal; se puede eliminar para recuperar espacio para las nuevas entradas. |
|
Entrada de caché de respuesta parcial. |
|
Entrada de caché permanente; exenta de la limpieza. |
|
No implementado actualmente. |
|
No implementado actualmente. |
|
Entrada de caché de vínculos visitados. |
[in] lpszHeaderInfo
Puntero al búfer que contiene la información de encabezado. Si este parámetro no es NULL, la información de encabezado se trata como atributos extendidos de la dirección URL que se devuelven en el miembro lpHeaderInfo de la estructura INTERNET_CACHE_ENTRY_INFO .
[in] cchHeaderInfo
Tamaño de la información de encabezado, en TCHAR. Si lpHeaderInfo no es NULL, se supone que este valor indica el tamaño del búfer que almacena la información de encabezado. Una aplicación puede mantener encabezados como parte de los datos y proporcionar cchHeaderInfo junto con un valor NULL para lpHeaderInfo.
[in] lpszFileExtension
Este parámetro está reservado y debe ser NULL.
[in] lpszOriginalUrl
Puntero a una cadena que contiene la dirección URL original, si se ha producido el redireccionamiento.
Valor devuelto
Devuelve TRUE si es correcto o FALSE en caso contrario. Para obtener información de error extendida, llame a GetLastError. A continuación se muestran los posibles valores de error.
| Código devuelto | Descripción |
|---|---|
|
El almacenamiento en caché está lleno. |
|
No se encuentra el archivo local especificado. |
Comentarios
El tipo STICKY_CACHE_ENTRY se usa para hacer que las entradas de caché estén exentas del scavenging. El tiempo de exención predeterminado para las entradas establecidas con CommitUrlCacheEntryW es de diez minutos. El tiempo exento se puede cambiar estableciendo el parámetro time expira en la estructura INTERNET_CACHE_ENTRY_INFO de la llamada a la función SetUrlCacheEntryInfo .
Si el almacenamiento en caché está lleno, CommitUrlCacheEntryW invoca la limpieza de la memoria caché para crear espacio para este nuevo archivo. Si la entrada de caché ya existe, la función sobrescribe la entrada si no está en uso. Una entrada se usa cuando se ha recuperado con RetrieveUrlCacheEntryStream o RetrieveUrlCacheEntryFile.
Los clientes que agreguen entradas a la memoria caché deben establecer los encabezados en al menos "HTTP/1.0 200 OK\r\n\r\n"; De lo contrario, Microsoft Internet Explorer y otras aplicaciones cliente deben ignorar la entrada.
Consulte Almacenamiento en caché para obtener código de ejemplo que llama a CreateUrlCacheEntryW.
Al igual que todos los demás aspectos de la API de WinINet, esta función no se puede llamar de forma segura desde DllMain ni desde los constructores y destructores de objetos globales.
Nota
El encabezado wininet.h define CommitUrlCacheEntry 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 Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wininet.h |
| Library | Wininet.lib |
| Archivo DLL | Wininet.dll |