Fungsi FindFirstUrlCacheEntryExA (wininet.h)
Memulai enumerasi cache Internet yang difilter.
Sintaks
HANDLE FindFirstUrlCacheEntryExA(
[in] LPCSTR lpszUrlSearchPattern,
[in] DWORD dwFlags,
[in] DWORD dwFilter,
[in] GROUPID GroupId,
[out] LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
[in, out] LPDWORD lpcbCacheEntryInfo,
[out] LPVOID lpGroupAttributes,
[in, out] LPDWORD lpcbGroupAttributes,
[in] LPVOID lpReserved
);
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, FindFirstUrlCacheEntryEx mengembalikan semua entri konten dalam cache.
[in] dwFlags
Mengontrol enumerasi. Tidak ada bendera yang saat ini diimplementasikan; parameter ini harus diatur ke nol.
[in] dwFilter
Bitmask yang menunjukkan jenis entri cache dan propertinya. Jenis entri cache meliputi: entri riwayat (URLHISTORY_CACHE_ENTRY), entri cookie (COOKIE_CACHE_ENTRY), dan konten cache normal (NORMAL_CACHE_ENTRY).
Parameter ini dapat berupa nol atau lebih dari bendera properti berikut, dan bendera jenis cache yang tercantum di bawah ini.
| Nilai | Makna |
|---|---|
|
Entri cache cookie. |
|
File entri cache yang telah diedit secara eksternal. Jenis entri cache ini dikecualikan dari pemulungan. |
|
Entri cache normal; dapat dihapus untuk memulihkan ruang untuk entri baru. |
|
Entri cache respons parsial. |
|
Entri cache lengket; dikecualikan dari memulung. |
|
Saat ini tidak diimplementasikan. |
|
Saat ini tidak diimplementasikan. |
|
Entri cache tautan yang dikunjungi. |
[in] GroupId
ID grup cache yang akan dijumlahkan. Atur parameter ini ke nol untuk menghitung semua entri yang tidak dikelompokkan.
[out] lpFirstCacheEntryInfo
Arahkan ke struktur INTERNET_CACHE_ENTRY_INFO untuk menerima informasi entri cache.
[in, out] lpcbCacheEntryInfo
Penunjuk ke variabel yang menunjukkan ukuran struktur yang dirujuk oleh parameter lpFirstCacheEntryInfo , dalam byte.
[out] lpGroupAttributes
Parameter ini dicadangkan dan harus NULL.
[in, out] lpcbGroupAttributes
Parameter ini dicadangkan dan harus NULL.
[in] lpReserved
Parameter ini dicadangkan dan harus NULL.
Nilai kembali
Mengembalikan handel yang valid jika berhasil, atau NULL sebaliknya. Untuk mendapatkan informasi kesalahan tertentu, hubungi GetLastError. Jika fungsi tidak menemukan file yang cocok, GetLastError mengembalikan ERROR_NO_MORE_FILES.
Keterangan
Handel yang dikembalikan dari FindFirstUrlCacheEntryEx digunakan dalam semua panggilan berikutnya ke FindNextUrlCacheEntryEx. Di akhir enumerasi, aplikasi harus memanggil FindCloseUrlCache.
Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.
Catatan
Header wininet.h mendefinisikan FindFirstUrlCacheEntryEx 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 |