GetUrlCacheEntryInfoExA 関数 (wininet.h)
HttpSendRequest 関数によってオフライン モードで適用されるリダイレクトを考慮して、指定された URL に関連付けられているキャッシュ エントリに関する情報を取得します。
構文
BOOL GetUrlCacheEntryInfoExA(
[in] LPCSTR lpszUrl,
[in, out, optional] LPINTERNET_CACHE_ENTRY_INFOA lpCacheEntryInfo,
[in, out, optional] LPDWORD lpcbCacheEntryInfo,
[out] LPSTR lpszRedirectUrl,
[in, out] LPDWORD lpcbRedirectUrl,
LPVOID lpReserved,
[in] DWORD dwFlags
);
パラメーター
[in] lpszUrl
キャッシュ エントリの名前を含む null で終わる文字列へのポインター。 名前文字列にはエスケープ文字を含めないようにしてください。
[in, out, optional] lpCacheEntryInfo
キャッシュ エントリに関する情報を受け取る INTERNET_CACHE_ENTRY_INFO 構造体へのポインター。 このパラメーターにはバッファーを割り当てる必要があります。
バッファーの必要なサイズは事前にわかっていないので、ほとんどの INTERNET_CACHE_ENTRY_INFO エントリのサイズを処理するのに十分なバッファーを割り当てることをお勧めします。 キャッシュ エントリのサイズ制限がないため、キャッシュを列挙する必要があるアプリケーションは、可変サイズのバッファーを割り当てるために準備する必要があります。
[in, out, optional] lpcbCacheEntryInfo
lpCacheEntryInfo バッファーのサイズをバイト単位で指定する変数へのポインター。 関数が戻るときに、変数にはバッファーにコピーされたバイト数、またはバッファーの必要なサイズ (バイト単位) が含まれます。
[out] lpszRedirectUrl
このパラメーターは予約されており、 NULL である必要があります。
[in, out] lpcbRedirectUrl
このパラメーターは予約されており、 NULL である必要があります。
lpReserved
このパラメーターは予約されており、 NULL である必要があります。
[in] dwFlags
このパラメーターは予約されており、0 である必要があります。
戻り値
URL が存在する場合は TRUE 、それ以外の場合は FALSE を 返します。 特定のエラー情報に対して GetLastError を呼び出します。 次のようなエラーが発生する可能性があります。
| リターン コード | 説明 |
|---|---|
|
キャッシュされたリダイレクトを考慮した後でも、キャッシュ インデックスに URL が見つかりませんでした。 |
|
lpCacheEntryInfo によって参照されるバッファーが、要求された情報を保持するのに十分な大きさではなかった。 必要なバッファーのサイズは lpdwCacheEntryInfoBufSize に返されます。 |
注釈
GetUrlCacheEntryInfoEx は URL 解析を行わないので、リソースがキャッシュされている場合でも、アンカー (#) を含む URL はキャッシュに見つかりません。 たとえば、URL http://example.com/example.htm#sample が渡された場合、関数は キャッシュ内にある場合 http://example.com/example.htm でもERROR_FILE_NOT_FOUNDを返します。
WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
注意
wininet.h ヘッダーは、GetUrlCacheEntryInfoEx をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |