Share via

FtpPutFileA 関数 (wininet.h)

  • [アーティクル]

FTP サーバーにファイルを格納します。

構文

BOOL FtpPutFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocalFile,
  [in] LPCSTR    lpszNewRemoteFile,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

パラメーター

[in] hConnect

FTP セッションへの処理。

[in] lpszLocalFile

ローカル システムから送信されるファイルの名前を含む null で終わる文字列へのポインター。

[in] lpszNewRemoteFile

リモート システムに作成されるファイルの名前を含む null で終わる文字列へのポインター。

[in] dwFlags

転送が発生する条件。 アプリケーションでは、1 つの転送の種類と、ファイルのキャッシュの制御方法を制御するフラグのいずれかを選択する必要があります。

転送の種類には、次のいずれかの値を指定できます。

値 意味
FTP_TRANSFER_TYPE_ASCII
 FTP の ASCII (タイプ A) 転送方法を使用してファイルを転送します。 コントロールと書式設定の情報は、ローカルの同等のものに変換されます。
FTP_TRANSFER_TYPE_BINARY
 FTP の Image (Type I) 転送方法を使用してファイルを転送します。 ファイルは、変更なしで存在するとおりに転送されます。 これは既定の転送方法です。
FTP_TRANSFER_TYPE_UNKNOWN
 既定値は FTP_TRANSFER_TYPE_BINARY です。
INTERNET_FLAG_TRANSFER_ASCII
 ファイルを ASCII として転送します。
INTERNET_FLAG_TRANSFER_BINARY
 ファイルをバイナリとして転送します。
 

ファイルのキャッシュを制御するには、次の値を使用します。 アプリケーションでは、次の値のうち 1 つ以上を使用できます。

値 意味
INTERNET_FLAG_HYPERLINK
 ネットワークからアイテムを再読み込みするかどうかを判断するときに、有効期限時間がなく、サーバーから LastModified 時刻が返されない場合は、強制的に再読み込みを行います。
INTERNET_FLAG_NEED_FILE
 ファイルをキャッシュできない場合は、一時ファイルを作成します。
INTERNET_FLAG_RELOAD
 要求されたファイル、オブジェクト、またはディレクトリ リストをキャッシュからではなく元のサーバーからダウンロードします。
INTERNET_FLAG_RESYNCHRONIZE
 最後にダウンロードされてからリソースが変更された場合は、HTTP リソースを再読み込みします。 すべての FTP リソースが再読み込みされます。

Windows XP および Windows Server 2003 R2 以前: Gopher リソースも再読み込みされます。

[in] dwContext

この検索を任意のアプリケーション データに関連付けるアプリケーション定義値を含む変数へのポインター。 このパラメーターは、アプリケーションが既に InternetSetStatusCallback を 呼び出して状態コールバックを設定している場合にのみ使用されます。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 特定のエラー メッセージを取得するには、 GetLastError を呼び出します。

注釈

FtpPutFile は、ファイルをローカルで読み取って FTP サーバーに格納することに関連するすべての簿記とオーバーヘッドを処理する高レベルのルーチンです。 ファイル データのみを送信する必要があるアプリケーション、またはファイル転送を厳密に制御する必要があるアプリケーションでは、 FtpOpenFile 関数と InternetWriteFile 関数を使用する必要があります。

dwFlags パラメーターでFILE_TRANSFER_TYPE_ASCIIが指定されている場合、ファイル データの変換により、コントロール文字と書式設定文字がローカルの同等の文字に変換されます。

lpszNewRemoteFile と lpszLocalFile の両方に、現在のディレクトリに対する相対ファイル名を部分的または完全修飾にすることができます。

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

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

注意

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

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wininet.h
Library Wininet.lib
[DLL] Wininet.dll

こちらもご覧ください

FTP セッション

WinINet 関数