INTERNET_CACHE_ENTRY_INFOA 結構 (wininet.h)

發行項
03/04/2024

包含網際網路快取中的項目相關資訊。

語法

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;

成員

dwStructSize

這個結構的大小，以位元組為單位。這個值可用來協助判斷快取系統的版本。

lpszSourceUrlName

包含 URL 名稱之 Null 終止字串的指標。字串會佔用這個結構結尾的記憶體區域。

lpszLocalFileName

包含本機檔名的 Null 終止字串指標。字串會佔用這個結構結尾的記憶體區域。

CacheEntryType

位掩碼，指出快取項目的類型及其屬性。快取專案類型包括：記錄專案 (URLHISTORY_CACHE_ENTRY) 、Cookie 專案 (COOKIE_CACHE_ENTRY) ，以及一般快取內容 (NORMAL_CACHE_ENTRY) 。

此成員可以是下列屬性旗標的零或多個，以及下面所列的快取類型旗標。

值	意義
EDITED_CACHE_ENTRY	已在外部編輯的快取項目檔。這個快取專案類型可豁免清除。
SPARSE_CACHE_ENTRY	部分回應快取項目。
STICKY_CACHE_ENTRY	可豁免清除 dwExemptDelta 所指定時間量的黏性快取專案。 CommitUrlCacheEntryA 和 CommitUrlCacheEntryW 所設定的預設值為一天。
TRACK_OFFLINE_CACHE_ENTRY	目前未實作。
TRACK_ONLINE_CACHE_ENTRY	目前未實作。

下列清單包含快取類型旗標。

值	意義
COOKIE_CACHE_ENTRY	Cookie 快取項目。
NORMAL_CACHE_ENTRY	一般快取項目；可以進行刪除來為新項目復原空間。
URLHISTORY_CACHE_ENTRY	已瀏覽過的連結快取項目。

dwUseCount

使用快取專案目前的 WinINEet 呼叫端數目。

dwHitRate

擷取快取項目的次數。

dwSizeLow

檔案大小的低序部分，以 位元組為單位。

dwSizeHigh

檔案大小的高序部分，以 位元組為單位。

LastModifiedTime

FILETIME 結構，其中包含此 URL 的上次修改時間，以 Greenwich 平均時間格式表示。

ExpireTime

FILETIME 結構，其中包含此檔案的到期時間，以 Greenwich 平均時間格式表示。

LastAccessTime

包含上次存取時間的 FILETIME 結構，以 Greenwich 平均時間格式表示。

LastSyncTime

FILETIME 結構，其中包含上次同步處理快取的時間。

lpHeaderInfo

包含標頭信息的緩衝區指標。緩衝區會佔用這個結構結尾的記憶體。

dwHeaderInfoSize

TCHAR 中 lpHeaderInfo 緩衝區的大小。

lpszFileExtension

字串的指標，其中包含用來擷取數據做為檔案的擴展名。字串會佔用這個結構結尾的記憶體區域。

dwReserved

dwExemptDelta

豁免上次存取時間，以秒為單位。

備註

沒有快取專案大小限制，因此需要列舉快取的應用程式必須準備好配置可變大小的緩衝區。如需詳細資訊，請參閱使用緩衝區。

注意 WinINet 不支援伺服器實作。此外，它不應該從服務使用。對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。

注意

wininet.h 標頭會將INTERNET_CACHE_ENTRY_INFO定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	wininet.h