Fungsi GetUrlCacheEntryInfoA (wininet.h)

Artikel
03/08/2023

Mengambil informasi tentang entri cache.

Sintaks

BOOL GetUrlCacheEntryInfoA(
  [in]      LPCSTR                       lpszUrlName,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

Parameter

[in] lpszUrlName

Penunjuk ke string yang dihentikan null yang berisi nama entri cache. String nama tidak boleh berisi karakter escape apa pun.

[out] lpCacheEntryInfo

Penunjuk ke struktur INTERNET_CACHE_ENTRY_INFO yang menerima informasi tentang entri cache. Buffer harus dialokasikan untuk parameter ini.

Karena ukuran buffer yang diperlukan tidak diketahui sebelumnya, yang terbaik adalah mengalokasikan buffer yang memadai untuk menangani ukuran sebagian besar entri INTERNET_CACHE_ENTRY_INFO . Tidak ada batas ukuran entri cache, sehingga aplikasi yang perlu menghitung cache harus disiapkan untuk mengalokasikan buffer berukuran variabel.

[in, out] lpcbCacheEntryInfo

Penunjuk ke variabel yang menentukan ukuran buffer lpCacheEntryInfo , dalam byte. Ketika fungsi kembali, variabel berisi jumlah byte yang disalin ke buffer, atau ukuran buffer yang diperlukan, dalam byte.

Nilai kembali

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Nilai kesalahan yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
ERROR_FILE_NOT_FOUND	Entri cache yang ditentukan tidak ditemukan di cache.
ERROR_INSUFFICIENT_BUFFER	Ukuran lpCacheEntryInfo seperti yang ditentukan oleh lpdwCacheEntryInfoBufferSize tidak cukup untuk memuat semua informasi. Nilai yang dikembalikan dalam lpdwCacheEntryInfoBufferSize menunjukkan ukuran buffer yang diperlukan untuk berisi semua informasi.

Keterangan

GetUrlCacheEntryInfo tidak melakukan penguraian URL apa pun, sehingga URL yang berisi jangkar (#) tidak akan ditemukan di cache, bahkan jika sumber daya di-cache. Misalnya, jika URL http://example.com/example.htm#sample diteruskan, fungsi mengembalikan ERROR_FILE_NOT_FOUND bahkan jika http://example.com/example.htm ada di cache.

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 GetUrlCacheEntryInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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