次の方法で共有


RetrieveUrlCacheEntryStreamA 関数 (wininet.h)

キャッシュ データにアクセスするための最も効率的で実装に依存しない方法を提供します。

構文

HANDLE RetrieveUrlCacheEntryStreamA(
  [in]      LPCSTR                       lpszUrlName,
  [out]     LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
  [in, out] LPDWORD                      lpcbCacheEntryInfo,
  [in]      BOOL                         fRandomRead,
  [in]      DWORD                        dwReserved
);

パラメーター

[in] lpszUrlName

キャッシュ エントリのソース名を含む null で終わる文字列へのポインター。 これは一意の名前である必要があります。 名前文字列にはエスケープ文字を含めないようにしてください。

[out] lpCacheEntryInfo

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

[in, out] lpcbCacheEntryInfo

lpCacheEntryInfo バッファーのサイズをバイト単位で指定する変数へのポインター。 関数から制御が戻ると、変数はバッファーにコピーされたバイト数、またはバッファーの必要なサイズ (バイト単位) を受け取ります。 このバッファー サイズは、INTERNET_CACHE_ENTRY_INFO 構造体と、その直後に格納される関連する文字列の両方に対応する必要があることに注意してください。

[in] fRandomRead

ストリームがランダム アクセス用に開いているかどうか。 ランダム アクセスのためにストリームを開くには、フラグを TRUE に設定します。

[in] dwReserved

このパラメーターは予約済みであり、0 である必要があります。

戻り値

関数が成功した場合、関数は、ReadUrlCacheEntryStream および UnlockUrlCacheEntryStream 関数 使用するための有効なハンドルを返します。

関数が失敗した場合は、NULLを返します。 拡張エラー情報を取得するには、GetLastError呼び出します。

考えられるエラー値は次のとおりです。

リターン コード 形容
ERROR_FILE_NOT_FOUND
ソース名で指定されたキャッシュ エントリがキャッシュ ストレージに見つかりません。
ERROR_INSUFFICIENT_BUFFER
lpdwCacheEntryInfoBufferSize で指定 lpCacheEntryInfo のサイズでは、すべての情報を含めるのに十分ではありません。 lpdwCacheEntryInfoBufferSize で返される値は、すべての情報を格納するために必要なバッファー サイズを示します。

備考

RetrieveUrlCacheEntryStream は URL 解析を行わないので、リソースがキャッシュされている場合でも、アンカー (#) を含む URL はキャッシュに見つかりません。 たとえば、URL http://adatum.com/example.htm#sample が渡された場合、http://adatum.com/example.htm がキャッシュ内にある場合でも、関数はERROR_FILE_NOT_FOUNDを返します。

ファイルの形式で URL データを必要としないキャッシュ クライアントは、この関数を使用して、特定の URL のデータにアクセスする必要があります。

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

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

手記

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

必要条件

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

関連項目

キャッシュ

WinINet Functions の