FindFirstUrlCacheEntryW

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

FindFirstUrlCacheEntryW lpszUrlSearchPattern, lpFirstCacheEntryInfo, lpcbCacheEntryInfo

lpszUrlSearchPattern : [wstr] 検索するソース名のパターンを格納した文字列へのポインタ。本パラメータには "cookie:"、"visited:"、または NULL のみを指定できる。クッキーを列挙するには "cookie:" を、URL 履歴エントリを列挙するには "visited:" を指定する。本パラメータが NULL の場合、FindFirstUrlCacheEntry はキャッシュ内のすべてのコンテンツエントリを返す。
lpFirstCacheEntryInfo : [var] INTERNET_CACHE_ENTRY_INFO 構造体へのポインタ。
lpcbCacheEntryInfo : [var] lpFirstCacheEntryInfo バッファのサイズ (バイト単位) を指定する変数へのポインタ。関数が戻ると、変数にはバッファにコピーされたバイト数、またはキャッシュエントリの取得に必要なサイズ (バイト単位) が格納される。

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

解説

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

[戻り値]
アプリケーションが FindNextUrlCacheEntry
関数で後続のキャッシュエントリを取得するために使用できるハンドルを返す。関数が失敗した場合、戻り値は NULL
である。拡張エラー情報を取得するには GetLastError を呼び出す。ERROR_INSUFFICIENT_BUFFER
は、lpdwFirstCacheEntryInfoBufferSize で指定された lpFirstCacheEntryInfo
のサイズが、すべての情報を格納するのに十分でないことを示す。lpdwFirstCacheEntryInfoBufferSize
に返される値は、すべての情報を格納するのに必要なバッファサイズを示す。

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

情報