INTERNET_CACHE_ENTRY_INFOA 構造体 (wininet.h)

[アーティクル]
03/08/2023

インターネットキャッシュ内のエントリについての情報を格納します。

構文

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) が含まれます。

このメンバーには、次のプロパティフラグと、以下に示すキャッシュ型フラグの 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 ヘッダーは、INTERNET_CACHE_ENTRY_INFOをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

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