INTERNET_CACHE_ENTRY_INFOW結構（wininet.h）

發行項
11/20/2024

包含因特網快取中專案的相關信息。

語法

typedef struct _INTERNET_CACHE_ENTRY_INFOW {
  DWORD    dwStructSize;
  LPWSTR   lpszSourceUrlName;
  LPWSTR   lpszLocalFileName;
  DWORD    CacheEntryType;
  DWORD    dwUseCount;
  DWORD    dwHitRate;
  DWORD    dwSizeLow;
  DWORD    dwSizeHigh;
  FILETIME LastModifiedTime;
  FILETIME ExpireTime;
  FILETIME LastAccessTime;
  FILETIME LastSyncTime;
  LPWSTR   lpHeaderInfo;
  DWORD    dwHeaderInfoSize;
  LPWSTR   lpszFileExtension;
  union {
    DWORD dwReserved;
    DWORD dwExemptDelta;
  };
} INTERNET_CACHE_ENTRY_INFOW, *LPINTERNET_CACHE_ENTRY_INFOW;

成員

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 的上次修改時間，以格林威治平均時間格式表示。

ExpireTime

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

LastAccessTime

FILETIME 結構，其中包含格林威治平均時間格式。

LastSyncTime

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

lpHeaderInfo

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

dwHeaderInfoSize

lpHeaderInfo 緩衝區的大小，TCHAR。

lpszFileExtension

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

dwReserved

dwExemptDelta

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

言論

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

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

注意

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

要求

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