Función CreateUrlCacheEntryA (wininet.h)
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 hará que se produzca un error en createUrlCacheEntry. Además, la cadena no debe contener caracteres 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.
Observaciones
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 los elementos se recuperan 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
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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 2000 Professional [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows 2000 Server [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
wininet.h |
| biblioteca de |
Wininet.lib |
| DLL de |
Wininet.dll |