Función CreateUrlCacheEntryA (wininet.h)

  • Artículo

Crea un nombre de archivo local para guardar la entrada de caché en función de la dirección URL especificada y la extensión de nombre de archivo.

Sintaxis

BOOL CreateUrlCacheEntryA(
  [in]  LPCSTR lpszUrlName,
  [in]  DWORD  dwExpectedFileSize,
  [in]  LPCSTR lpszFileExtension,
  [out] LPSTR  lpszFileName,
  [in]  DWORD  dwReserved
);

Parámetros

[in] lpszUrlName

Puntero a un valor de cadena que contiene el nombre de la dirección URL. La cadena debe contener un valor; Una cadena vacía provocará un error en CreateUrlCacheEntry . Además, la cadena no debe contener ningún carácter de escape.

[in] dwExpectedFileSize

Tamaño esperado del archivo necesario para almacenar los datos correspondientes a la entidad de origen, en TCHAR. Si se desconoce el tamaño esperado, establezca este valor en cero.

[in] lpszFileExtension

Puntero a un valor de cadena que contiene un nombre de extensión del archivo en el almacenamiento local.

[out] lpszFileName

Puntero a un búfer que recibe el nombre de archivo. El búfer debe ser lo suficientemente grande como para almacenar la ruta de acceso del archivo creado (al menos MAX_PATH caracteres de longitud).

[in] dwReserved

Este parámetro está reservado y debe ser 0.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve TRUE.

Si se produce un error en la función, devuelve FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Después de llamar a CreateUrlCacheEntry , la aplicación puede escribir directamente en el archivo en el almacenamiento local. Cuando el archivo se recibe por completo, el autor de la llamada debe llamar a CommitUrlCacheEntry para confirmar la entrada en la memoria caché.

WinINet intenta descodificar parámetros Unicode según la página de códigos del sistema. Las aplicaciones deben asegurarse de que los parámetros Unicode están codificados correctamente para la página de códigos del sistema. Las aplicaciones pueden establecer la página de códigos del sistema con InternetSetOption como se muestra en el ejemplo de código siguiente:

DWORD CP_SHIFT_JIS = 932;  // ANSI/OEM  Japanese, Shift-JIS
InternetSetOption( hRequest, 
                   INTERNET_OPTION_CODEPAGE,
                   &CP_SHIFT_JIS, 
                   sizeof(DWORD) );

Si el parámetro Unicode no está codificado correctamente en la página de códigos del sistema, WinINet intenta descodificar UTF8.

Cuando se recuperan elementos de la memoria caché, la página de códigos del sistema que se usó para colocar el elemento en la memoria caché debe coincidir con la página de códigos del sistema actual para el usuario. En el caso de las aplicaciones que se ejecutan en IE6 y versiones anteriores, si se produce un error en la descodificación de la página de códigos del sistema, WinINet intenta descodificar UTF8.

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

Nota

El encabezado wininet.h define CreateUrlCacheEntry 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

Requisito Value
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

Consulte también

Almacenamiento en caché

CommitUrlCacheEntry

Funciones de WinINet