Fungsi FindFirstUrlCacheEntryW (wininet.h)

Artikel
03/08/2023

Memulai enumerasi cache Internet.

Sintaks

HANDLE FindFirstUrlCacheEntryW(
  [in]      LPCWSTR                      lpszUrlSearchPattern,
  [out]     LPINTERNET_CACHE_ENTRY_INFOW lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

Parameter

[in] lpszUrlSearchPattern

Penunjuk ke string yang berisi pola nama sumber untuk dicari. Parameter ini hanya dapat diatur ke "cookie:", "visited:", atau NULL. Atur parameter ini ke "cookie:" untuk menghitung cookie atau "dikunjungi:" untuk menghitung entri Riwayat URL dalam cache. Jika parameter ini NULL, FindFirstUrlCacheEntry mengembalikan semua entri konten dalam cache.

[out] lpFirstCacheEntryInfo

Penunjuk ke struktur INTERNET_CACHE_ENTRY_INFO .

[in, out] lpcbCacheEntryInfo

Penunjuk ke variabel yang menentukan ukuran buffer lpFirstCacheEntryInfo , dalam byte. Ketika fungsi kembali, variabel berisi jumlah byte yang disalin ke buffer, atau ukuran yang diperlukan untuk mengambil entri cache, dalam byte.

Nilai kembali

Mengembalikan handel yang dapat digunakan aplikasi dalam fungsi FindNextUrlCacheEntry untuk mengambil entri berikutnya dalam cache. Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

ERROR_INSUFFICIENT_BUFFER menunjukkan bahwa ukuran lpFirstCacheEntryInfo seperti yang ditentukan oleh lpdwFirstCacheEntryInfoBufferSize tidak cukup untuk memuat semua informasi. Nilai yang dikembalikan dalam lpdwFirstCacheEntryInfoBufferSize menunjukkan ukuran buffer yang diperlukan untuk memuat semua informasi.

Keterangan

Handel yang dikembalikan dari FindFirstUrlCacheEntry digunakan dalam semua panggilan berikutnya ke FindNextUrlCacheEntry. Di akhir enumerasi, aplikasi harus memanggil FindCloseUrlCache.

FindFirstUrlCacheEntry dan FindNextUrlCacheEntry mengembalikan informasi ukuran variabel. Jika ERROR_INSUFFICIENT_BUFFER dikembalikan, aplikasi harus mengalokasikan buffer ukuran yang ditentukan oleh lpdwFirstCacheEntryInfoBufferSize. Untuk informasi selengkapnya, lihat Menggunakan Buffer.

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 FindFirstUrlCacheEntry 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


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

Fungsi WinINet

Bagikan melalui