FindFirstUrlCacheEntryExW

インターネットキャッシュのフィルタ付き列挙を開始する。(Unicode)

FindFirstUrlCacheEntryExW lpszUrlSearchPattern, dwFlags, dwFilter, GroupId, lpFirstCacheEntryInfo, lpcbCacheEntryInfo, lpGroupAttributes, lpcbGroupAttributes, lpReserved

lpszUrlSearchPattern : [wstr] 検索するソース名のパターンを格納した文字列へのポインタ。本パラメータには "cookie:"、"visited:"、または NULL のみを指定できる。クッキーを列挙するには "cookie:" を、URL 履歴エントリを列挙するには "visited:" を指定する。本パラメータが NULL の場合、FindFirstUrlCacheEntryEx はキャッシュ内のすべてのコンテンツエントリを返す。
dwFlags : [int] 列挙を制御する。現時点でフラグは実装されておらず、本パラメータは 0 に設定しなければならない。
dwFilter : [int] キャッシュエントリの種別とプロパティを示すビットマスク。キャッシュエントリ種別には、履歴エントリ (URLHISTORY_CACHE_ENTRY)、クッキーエントリ (COOKIE_CACHE_ENTRY)、通常のキャッシュコンテンツ (NORMAL_CACHE_ENTRY) がある。本パラメータには、以下のプロパティフラグおよびキャッシュ種別フラグを 0 個以上指定できる。
GroupId : [int64] 列挙対象のキャッシュグループの ID。グループに属さないすべてのエントリを列挙するには、本パラメータを 0 に設定する。
lpFirstCacheEntryInfo : [var] キャッシュエントリ情報を受け取る INTERNET_CACHE_ENTRY_INFO 構造体へのポインタ。
lpcbCacheEntryInfo : [var] lpFirstCacheEntryInfo パラメータが参照する構造体のサイズ (バイト単位) を示す変数へのポインタ。
lpGroupAttributes : [intptr] 本パラメータは予約されており、NULL を指定しなければならない。
lpcbGroupAttributes : [var] 本パラメータは予約されており、NULL を指定しなければならない。
lpReserved : [intptr] 本パラメータは予約されており、NULL を指定しなければならない。

(プラグイン / モジュール : wininet.dll)

解説

インターネットキャッシュのフィルタ付き列挙を開始する。(Unicode)

[戻り値]
成功した場合は有効なハンドルを、失敗した場合は NULL を返す。具体的なエラー情報を取得するには GetLastError
を呼び出す。一致するファイルが見つからなかった場合、GetLastError は ERROR_NO_MORE_FILES を返す。

[備考]
FindFirstUrlCacheEntryEx から返されたハンドルは、それ以降のすべての
FindNextUrlCacheEntryEx の呼び出しで使用される。列挙の終了時に、アプリケーションは
FindCloseUrlCache を呼び出すべきである。WinINet API の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは FindFirstUrlCacheEntryEx
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報