INTERNET_CACHE_ENTRY_INFOA 構造体 (wininet.h)

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

構文

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 で指定された時間の間、清掃から除外されるスティッキー キャッシュ エントリ。 CommitUrlCacheEntryACommitUrlCacheEntryW によって設定される既定値は 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

TCHARlpHeaderInfo バッファーのサイズ。

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

こちらもご覧ください

FindFirstUrlCacheEntry

FindFirstUrlCacheEntryEx

FindNextUrlCacheEntry

FindNextUrlCacheEntryEx

GetUrlCacheEntryInfo

GetUrlCacheEntryInfoEx

SetUrlCacheEntryInfo