struktur INTERNET_CACHE_ENTRY_INFOA (wininet.h)

Artikel
03/08/2023

Berisi informasi tentang entri dalam singgahan Internet.

Sintaks

typedef struct _INTERNET_CACHE_ENTRY_INFOA {
  DWORD    dwStructSize;
  LPSTR    lpszSourceUrlName;
  LPSTR    lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPSTR    lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPSTR    lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOA, *LPINTERNET_CACHE_ENTRY_INFOA;

Anggota

dwStructSize

Ukuran struktur ini, dalam byte. Nilai ini dapat digunakan untuk membantu menentukan versi sistem cache.

lpszSourceUrlName

Penunjuk ke string yang dihentikan null yang berisi nama URL. String menempati area memori di akhir struktur ini.

lpszLocalFileName

Penunjuk ke string yang dihentikan null yang berisi nama file lokal. String menempati area memori di akhir struktur ini.

CacheEntryType

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).

Anggota ini bisa menjadi nol atau lebih dari bendera properti berikut, dan bendera jenis cache yang tercantum di bawah ini.

Nilai	Makna
EDITED_CACHE_ENTRY	File entri cache yang telah diedit secara eksternal. Jenis entri cache ini dikecualikan dari pemulungan.
SPARSE_CACHE_ENTRY	Entri cache respons parsial.
STICKY_CACHE_ENTRY	Entri cache lengket yang dikecualikan dari pemulungan untuk jumlah waktu yang ditentukan oleh dwExemptDelta. Nilai default yang ditetapkan oleh CommitUrlCacheEntryA dan CommitUrlCacheEntryW adalah satu hari.
TRACK_OFFLINE_CACHE_ENTRY	Saat ini tidak diimplementasikan.
TRACK_ONLINE_CACHE_ENTRY	Saat ini tidak diimplementasikan.

Daftar berikut berisi bendera jenis cache.

Nilai	Makna
COOKIE_CACHE_ENTRY	Entri cache cookie.
NORMAL_CACHE_ENTRY	Entri cache normal; dapat dihapus untuk memulihkan ruang untuk entri baru.
URLHISTORY_CACHE_ENTRY	Entri cache tautan yang dikunjungi.

dwUseCount

Jumlah penelepon WinINEet saat ini menggunakan entri cache.

dwHitRate

Berapa kali entri cache diambil.

dwSizeLow

Bagian berurutan rendah dari ukuran file, dalam byte.

dwSizeHigh

Bagian berurutan tinggi dari ukuran file, dalam byte.

LastModifiedTime

Struktur FILETIME yang berisi waktu terakhir yang dimodifikasi dari URL ini, dalam format waktu rata-rata Greenwich.

ExpireTime

Struktur FILETIME yang berisi waktu kedaluwarsa file ini, dalam format waktu rata-rata Greenwich.

LastAccessTime

Struktur FILETIME yang berisi waktu terakhir yang diakses, dalam format waktu rata-rata Greenwich.

LastSyncTime

Struktur FILETIME yang berisi terakhir kali cache disinkronkan.

lpHeaderInfo

Penunjuk ke buffer yang berisi informasi header. Buffer menempati memori di akhir struktur ini.

dwHeaderInfoSize

Ukuran buffer lpHeaderInfo , dalam TCHAR.

lpszFileExtension

Penunjuk ke string yang berisi ekstensi nama file yang digunakan untuk mengambil data sebagai file. String menempati area memori di akhir struktur ini.

dwReserved

dwExemptDelta

Waktu pengecualian dari waktu terakhir yang diakses, dalam detik.

Keterangan

Tidak ada batas ukuran entri cache, sehingga aplikasi yang perlu menghitung cache harus disiapkan untuk mengalokasikan buffer berukuran variabel. Untuk informasi selengkapnya, lihat Menggunakan Buffer.

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 INTERNET_CACHE_ENTRY_INFO 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]
Header	wininet.h