次の方法で共有

FindFirstUrlCacheEntryA 関数 (wininet.h)

  • [アーティクル]

インターネット キャッシュの列挙を開始します。

構文

HANDLE FindFirstUrlCacheEntryA(
  [in]      LPCSTR                       lpszUrlSearchPattern,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpFirstCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

パラメーター

[in] lpszUrlSearchPattern

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

[out] lpFirstCacheEntryInfo

INTERNET_CACHE_ENTRY_INFO 構造体へのポインター。

[in, out] lpcbCacheEntryInfo

lpFirstCacheEntryInfo バッファーのサイズをバイト単位で指定する変数へのポインター。 関数が戻るときに、変数にはバッファーにコピーされたバイト数、またはキャッシュ エントリを取得するために必要なサイズ (バイト単位) が含まれます。

戻り値

FindNextUrlCacheEntry 関数でアプリケーションがキャッシュ内の後続のエントリを取得するために使用できるハンドルを返します。 関数が失敗した場合、戻り値は NULL。 拡張エラー情報を取得するには、GetLastError呼び出します。

ERROR_INSUFFICIENT_BUFFERは、lpdwFirstCacheEntryInfoBufferSize で指定 lpFirstCacheEntryInfo のサイズが、すべての情報を含むには不十分であることを示します。 lpdwFirstCacheEntryInfoBufferSize 返される値は、すべての情報を格納するために必要なバッファー サイズを示します。

備考

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

FindFirstUrlCacheEntry と FindNextUrlCacheEntry 変数サイズ情報を返します。 ERROR_INSUFFICIENT_BUFFERが返された場合、アプリケーションは lpdwFirstCacheEntryInfoBufferSizeで指定されたサイズのバッファー 割り当てる必要があります。 詳細については、「バッファーの使用 」を参照してください。

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

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

手記

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

必要条件

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

関連項目

キャッシュ

WinINet Functions の