次の方法で共有

CreateUrlCacheEntryA 関数 (wininet.h)

  • [アーティクル]

指定した URL とファイル名拡張子に基づいて、キャッシュ エントリを保存するためのローカル ファイル名を作成します。

構文

BOOL CreateUrlCacheEntryA(
  [in]  LPCSTR lpszUrlName,
  [in]  DWORD  dwExpectedFileSize,
  [in]  LPCSTR lpszFileExtension,
  [out] LPSTR  lpszFileName,
  [in]  DWORD  dwReserved
);

パラメーター

[in] lpszUrlName

URL の名前を含む文字列値へのポインター。 文字列には値を含む必要があります。空の文字列を指定すると、CreateUrlCacheEntry 失敗します。 さらに、文字列にはエスケープ文字を含めてはなりません。

[in] dwExpectedFileSize

ソース エンティティに対応するデータを格納するために必要なファイルのサイズは、TCHAR必要です。 予想されるサイズが不明な場合は、この値を 0 に設定します。

[in] lpszFileExtension

ローカル ストレージ内のファイルの拡張子名を含む文字列値へのポインター。

[out] lpszFileName

ファイル名を受け取るバッファーへのポインター。 バッファーは、作成されたファイルのパスを格納するのに十分な大きさにする必要があります (少なくともMAX_PATH文字の長さ)。

[in] dwReserved

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

戻り値

関数が成功した場合、関数は TRUE返します。

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

備考

CreateUrlCacheEntry 呼び出されると、アプリケーションはローカル ストレージ内のファイルに直接書き込むことができます。 ファイルが完全に受信されると、呼び出し元は、CommitUrlCacheEntry を呼び出して、キャッシュ内のエントリをコミットする必要があります。

WinINet は、システム コード ページに従って Unicode パラメーターのデコードを試みます。 アプリケーションでは、システム コード ページに対して Unicode パラメーターが適切にエンコードされていることを確認する必要があります。 アプリケーションは、次のコード例に示すように、InternetSetOption を使用してシステム コード ページを設定できます。

DWORD CP_SHIFT_JIS = 932;  // ANSI/OEM  Japanese, Shift-JIS
InternetSetOption( hRequest,
                   INTERNET_OPTION_CODEPAGE,
                   &CP_SHIFT_JIS,
                   sizeof(DWORD) );

Unicode パラメーターがシステム コード ページに正しくエンコードされていない場合、WinINet は UTF8 デコードを試みます。

キャッシュから項目を取得する場合、キャッシュに項目を配置するために使用されたシステム コード ページは、ユーザーの現在のシステム コード ページと一致する必要があります。 IE6 以前で実行されているアプリケーションの場合、システム コード ページのデコードに失敗した場合、WinINet は UTF8 デコードを試みます。

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

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

手記

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

必要条件

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

関連項目

キャッシュ

CommitUrlCacheEntry の

WinINet Functions の