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 サービス (WinHTTP) を使用します。
 

Note

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

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

関連項目

キャッシュ

WinINet 関数