次の方法で共有

FindFirstUrlCacheEntryExA 関数 (wininet.h)

  • [アーティクル]

インターネット キャッシュのフィルター処理された列挙を開始します。

構文

HANDLE FindFirstUrlCacheEntryExA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [in]      DWORD                        dwFlags,
  [in]      DWORD                        dwFilter,
  [in]      GROUPID                      GroupId,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo,
  [out]     LPVOID                       lpGroupAttributes,
  [in, out] LPDWORD                      lpcbGroupAttributes,
  [in]      LPVOID                       lpReserved
);

パラメーター

[in] lpszUrlSearchPattern

検索するソース名パターンを含む文字列へのポインター。 このパラメーターは、"cookie:"、"visited:"、または NULL にのみ設定できます。 Cookie を列挙するにはこのパラメーターを "cookie:" に設定し、キャッシュ内の URL 履歴エントリを列挙する場合は "visited:" に設定します。 このパラメーターが NULL の場合 FindFirstUrlCacheEntryEx はキャッシュ内のすべてのコンテンツ エントリを返します。

[in] dwFlags

列挙を制御します。 現在、フラグは実装されていません。このパラメーターは 0 に設定する必要があります。

[in] dwFilter

キャッシュ エントリの種類とそのプロパティを示すビットマスク。 キャッシュ エントリの種類には、履歴エントリ (URLHISTORY_CACHE_ENTRY)、Cookie エントリ (COOKIE_CACHE_ENTRY)、および通常のキャッシュされたコンテンツ (NORMAL_CACHE_ENTRY) が含まれます。

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

価値 意味
COOKIE_CACHE_ENTRY
 Cookie キャッシュ エントリ。
EDITED_CACHE_ENTRY
 外部で編集されたキャッシュ エントリ ファイル。 このキャッシュ エントリの種類は、清掃から除外されます。
NORMAL_CACHE_ENTRY
 通常のキャッシュ エントリ。は、新しいエントリの領域を回復するために削除できます。
SPARSE_CACHE_ENTRY
 部分的な応答キャッシュ エントリ。
STICKY_CACHE_ENTRY
 固定キャッシュ エントリ。清掃から除外されます。
TRACK_OFFLINE_CACHE_ENTRY
 現在実装されていません。
TRACK_ONLINE_CACHE_ENTRY
 現在実装されていません。
URLHISTORY_CACHE_ENTRY
 アクセスされたリンク キャッシュ エントリ。

[in] GroupId

列挙するキャッシュ グループの ID。 グループ化されていないすべてのエントリを列挙するには、このパラメーターを 0 に設定します。

[out] lpFirstCacheEntryInfo

キャッシュ エントリ情報を受け取る INTERNET_CACHE_ENTRY_INFO 構造体へのポインター。

[in, out] lpcbCacheEntryInfo

lpFirstCacheEntryInfo パラメーターによって参照される構造体のサイズをバイト単位で示す変数へのポインター。

[out] lpGroupAttributes

このパラメーターは予約されており、NULL である必要があります。

[in, out] lpcbGroupAttributes

このパラメーターは予約されており、NULL である必要があります。

[in] lpReserved

このパラメーターは予約されており、NULL である必要があります。

戻り値

成功した場合は有効なハンドルを返し、それ以外の場合は NULL を返します。 特定のエラー情報を取得するには、GetLastError呼び出します。 関数で一致するファイルが見つからない場合、GetLastError はERROR_NO_MORE_FILESを返します。

備考

FindFirstUrlCacheEntryEx から返されるハンドルは、FindNextUrlCacheEntryExへの後続のすべての呼び出しで使用されます。 列挙の最後に、アプリケーションは FindCloseUrlCache呼び出す必要があります。

WinINet API の他のすべての側面と同様に、この関数は DllMain またはグローバル オブジェクトのコンストラクターとデストラクターから安全に呼び出すことはできません。

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

手記

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

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

キャッシュ

WinINet Functions の