FindNextUrlCacheEntryA 関数 (wininet.h)

  • [アーティクル]

インターネット キャッシュ内の次のエントリを取得します。

構文

BOOL FindNextUrlCacheEntryA(
  [in]      HANDLE                       hEnumHandle,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpNextCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo
);

パラメーター

[in] hEnumHandle

FindFirstUrlCacheEntry の以前の呼び出しから取得した列挙体を処理します。

[out] lpNextCacheEntryInfo

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

[in, out] lpcbCacheEntryInfo

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

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 考えられるエラー値は次のとおりです。

リターン コード 説明
ERROR_INSUFFICIENT_BUFFER
 lpdwNextCacheEntryInfoBufferSize で指定された lpNextCacheEntryInfo のサイズは、すべての情報を格納するのに十分ではありません。 lpdwNextCacheEntryInfoBufferSize で返される値は、すべての情報を格納するために必要なバッファー サイズを示します。
ERROR_NO_MORE_ITEMS
 列挙が完了しました。

解説

キャッシュ内の最後の項目が返されるまで、 FindNextUrlCacheEntry を呼び出し続けます。

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

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

Note

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

要件

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

関連項目

キャッシュ

WinINet 関数