Fungsi FindFirstUrlCacheEntryExA (wininet.h)

  • Artikel

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
COOKIE_CACHE_ENTRY
 Entri cache cookie.
EDITED_CACHE_ENTRY
 File entri cache yang telah diedit secara eksternal. Jenis entri cache ini dikecualikan dari pemulungan.
NORMAL_CACHE_ENTRY
 Entri cache normal; dapat dihapus untuk memulihkan ruang untuk entri baru.
SPARSE_CACHE_ENTRY
 Entri cache respons parsial.
STICKY_CACHE_ENTRY
 Entri cache lengket; dikecualikan dari memulung.
TRACK_OFFLINE_CACHE_ENTRY
 Saat ini tidak diimplementasikan.
TRACK_ONLINE_CACHE_ENTRY
 Saat ini tidak diimplementasikan.
URLHISTORY_CACHE_ENTRY
 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 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 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

Lihat juga

Penembolokan

Fungsi WinINet