次の方法で共有

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

キャッシュ エントリの名前を含む -terminated 文字列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 を呼び出します。 考えられるエラーは次のとおりです。

リターン コード 形容
ERROR_FILE_NOT_FOUND
 キャッシュされたリダイレクトを考慮した後でも、URL がキャッシュ インデックスに見つかりませんでした。
ERROR_INSUFFICIENT_BUFFER
 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 では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、Microsoft Windows HTTP Services (WinHTTP)を使用します。
 

手記

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

必要条件

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

関連項目

キャッシュ

WinINet Functions の