INTERNET_CACHE_ENTRY_INFOA構造体 (wininet.h)

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

このメンバーには、次のプロパティフラグの 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

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

ExpireTime

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

LastAccessTime

FILETIME 構造体、グリニッジ標準時形式で、最後にアクセスした時刻を含みます。

LastSyncTime

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

lpHeaderInfo

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

dwHeaderInfoSize

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

lpszFileExtension

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

dwReserved

dwExemptDelta

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

備考

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

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

手記

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

必要条件

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

次の方法で共有

INTERNET_CACHE_ENTRY_INFOA構造体 (wininet.h)

構文

メンバーズ

備考

必要条件

関連項目

フィードバック

その他のリソース