Fungsi FindFirstUrlCacheEntryA (wininet.h)

  • Artikel

Memulai enumerasi cache Internet.

Sintaks

HANDLE FindFirstUrlCacheEntryA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA 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

Arahkan 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 berisi semua informasi. Nilai yang dikembalikan dalam lpdwFirstCacheEntryInfoBufferSize menunjukkan ukuran buffer yang diperlukan untuk berisi 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 praprosedur 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