Fungsi GetUrlCacheEntryInfoExA (wininet.h)
Mengambil informasi tentang entri cache yang terkait dengan URL yang ditentukan, dengan mempertimbangkan pengalihan apa pun yang diterapkan dalam mode offline oleh fungsi HttpSendRequest .
Sintaks
BOOL GetUrlCacheEntryInfoExA(
[in] LPCSTR lpszUrl,
[in, out, optional] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
[in, out, optional] LPDWORD lpcbCacheEntryInfo,
[out] LPSTR lpszRedirectUrl,
[in, out] LPDWORD lpcbRedirectUrl,
LPVOID lpReserved,
[in] DWORD dwFlags
);
Parameter
[in] lpszUrl
Penunjuk ke string yang dihentikan null yang berisi nama entri cache. String nama tidak boleh berisi karakter escape apa pun.
[in, out, optional] 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, optional] 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.
[out] lpszRedirectUrl
Parameter ini dicadangkan dan harus NULL.
[in, out] lpcbRedirectUrl
Parameter ini dicadangkan dan harus NULL.
lpReserved
Parameter ini dicadangkan dan harus NULL.
[in] dwFlags
Parameter ini dicadangkan dan harus 0.
Nilai kembali
Mengembalikan TRUE jika URL berada, atau FALSE jika tidak. Panggil GetLastError untuk informasi kesalahan tertentu. Kemungkinan kesalahan termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
URL tidak ditemukan dalam indeks cache, bahkan setelah mempertimbangkan pengalihan yang di-cache. |
|
Buffer yang dirujuk oleh lpCacheEntryInfo tidak cukup besar untuk menyimpan informasi yang diminta. Ukuran buffer yang diperlukan akan dikembalikan ke lpdwCacheEntryInfoBufSize. |
Keterangan
GetUrlCacheEntryInfoEx 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
Header wininet.h mendefinisikan GetUrlCacheEntryInfoEx 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
Persyaratan | Nilai |
---|---|
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk