INTERNET_CACHE_ENTRY_INFOW構造体 (wininet.h)

[アーティクル]
03/13/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) が含まれます。

このメンバーには、次のプロパティフラグと、以下に示すキャッシュ型フラグの 0 個以上を指定できます。

値	意味
EDITED_CACHE_ENTRY	外部で編集されたキャッシュエントリファイル。このキャッシュエントリの種類は、清掃から除外されます。
SPARSE_CACHE_ENTRY	部分的な応答キャッシュエントリ。
STICKY_CACHE_ENTRY	dwExemptDelta によって指定された時間だけ、清掃から除外される固定キャッシュエントリ。 CommitUrlCacheEntryA および CommitUrlCacheEntryW によって設定される既定値は 1 日です。
TRACK_OFFLINE_CACHE_ENTRY	現在、実装されていません。
TRACK_ONLINE_CACHE_ENTRY	現在、実装されていません。

次の一覧には、キャッシュの種類のフラグが含まれています。

値	意味
COOKIE_CACHE_ENTRY	Cookie キャッシュエントリ。
NORMAL_CACHE_ENTRY	通常のキャッシュエントリ。新しいエントリの領域を回復するために削除できます。
URLHISTORY_CACHE_ENTRY	表示済みのリンクキャッシュエントリ。

dwUseCount

キャッシュエントリを使用する WinINEet 呼び出し元の現在の数。

dwHitRate

キャッシュエントリが取得された回数。

dwSizeLow

ファイルサイズの下位部分 ( バイト単位)。

dwSizeHigh

ファイルサイズの高次部分 ( バイト単位)。

LastModifiedTime

グリニッジ標準時形式で、この URL の最終変更時刻を含む FILETIME 構造体。

ExpireTime

このファイルの有効期限を含む FILETIME 構造体 (グリニッジ標準時形式)。

LastAccessTime

最後にアクセスされた時刻をグリニッジ標準時形式で含む FILETIME 構造体。

LastSyncTime

キャッシュが最後に同期された時刻を含む FILETIME 構造体。

lpHeaderInfo

ヘッダー情報を含むバッファーへのポインター。バッファーは、この構造体の末尾にあるメモリを占有します。

dwHeaderInfoSize

TCHAR の lpHeaderInfo バッファーのサイズ。

lpszFileExtension

データをファイルとして取得するために使用されるファイル名拡張子を含む文字列へのポインター。文字列は、この構造体の末尾にあるメモリ領域を占有します。

dwReserved

dwExemptDelta

最後にアクセスした時刻からの除外時間 (秒単位)。

注釈

キャッシュエントリのサイズ制限がないため、キャッシュを列挙する必要があるアプリケーションは、可変サイズのバッファーを割り当てる準備をする必要があります。詳細については、「バッファーの使用」を参照してください。

メモ WinINet では、サーバーの実装はサポートされていません。また、サービスから使用しないでください。サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。

注意

wininet.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてINTERNET_CACHE_ENTRY_INFOを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	wininet.h