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 である必要があります。
戻り値
関数が成功した場合、関数は、
関数が失敗した場合は、NULLを返します。 拡張エラー情報を取得するには、GetLastError
考えられるエラー値は次のとおりです。
リターン コード | 形容 |
---|---|
|
ソース名で指定されたキャッシュ エントリがキャッシュ ストレージに見つかりません。 |
|
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.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RetrieveUrlCacheEntryStream を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
ターゲット プラットフォーム の |
ウィンドウズ |
ヘッダー | wininet.h |
ライブラリ | Wininet.lib |
DLL | Wininet.dll |
関連項目
WinINet Functions の