Fungsi CreateUrlCacheEntryA (wininet.h)

Membuat nama file lokal untuk menyimpan entri cache berdasarkan URL yang ditentukan dan ekstensi nama file.

Sintaksis

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

Parameter

[in] lpszUrlName

Penunjuk ke nilai string yang berisi nama URL. String harus berisi nilai; string kosong akan menyebabkan CreateUrlCacheEntry gagal. Selain itu, string tidak boleh berisi karakter escape apa pun.

[in] dwExpectedFileSize

Ukuran file yang diharapkan diperlukan untuk menyimpan data yang sesuai dengan entitas sumber, dalam TCHAR. Jika ukuran yang diharapkan tidak diketahui, atur nilai ini ke nol.

[in] lpszFileExtension

Penunjuk ke nilai string yang berisi nama ekstensi file di penyimpanan lokal.

[out] lpszFileName

Penunjuk ke buffer yang menerima nama file. Buffer harus cukup besar untuk menyimpan jalur file yang dibuat (panjangnya setidaknya MAX_PATH karakter).

[in] dwReserved

Parameter ini dicadangkan dan harus 0.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan TRUE.

Jika fungsi gagal, fungsi mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Setelah createUrlCacheEntry dipanggil, aplikasi dapat menulis langsung ke file di penyimpanan lokal. Ketika file benar-benar diterima, pemanggil harus memanggil CommitUrlCacheEntry untuk menerapkan entri di cache.

WinINet mencoba mendekode parameter Unicode sesuai dengan halaman kode sistem. Aplikasi harus memastikan bahwa parameter Unicode dikodekan dengan benar untuk halaman kode sistem. Aplikasi dapat mengatur halaman kode sistem dengan InternetSetOption seperti yang ditunjukkan dalam contoh kode berikut:

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

Jika parameter Unicode tidak dikodekan dengan benar ke halaman kode sistem, WinINet mencoba decoding UTF8.

Ketika item diambil dari cache, halaman kode sistem yang digunakan untuk menempatkan item dalam cache harus cocok dengan halaman kode sistem saat ini untuk pengguna. Untuk aplikasi yang berjalan di bawah IE6 dan yang lebih lama, jika decoding untuk halaman kode sistem gagal, WinINet mencoba decoding UTF8.

Seperti semua aspek lain dari API WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

Note WinINet tidak mendukung implementasi server. Selain itu, tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).

 

Nota

Header wininet.h mendefinisikan CreateUrlCacheEntry sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	wininet.h
Pustaka	Wininet.lib
DLL	Wininet.dll

Lihat juga

penembolokan

CommitUrlCacheEntry

Fungsi WinINet