Fungsi CreateUrlCacheEntryA (wininet.h)

Artikel
08/27/2023

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

Sintaks

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.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan TRUE.

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

Keterangan

Setelah CreateUrlCacheEntry dipanggil, aplikasi dapat menulis langsung ke file di penyimpanan lokal. Ketika file benar-benar diterima, pemanggil harus memanggil CommitUrlCacheEntry untuk menerapkan entri dalam 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,
                   &amp;CP_SHIFT_JIS, 
                   sizeof(DWORD) );

Jika parameter Unicode tidak dikodekan dengan benar ke halaman kode sistem, WinINet mencoba pendekodean 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 pendekodean untuk halaman kode sistem gagal, WinINet mencoba pendekodean UTF8.

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

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

Catatan

Header wininet.h mendefinisikan CreateUrlCacheEntry sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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

Lihat juga

Penembolokan

CommitUrlCacheEntry

Fungsi WinINet