FtpPutFileW

FTP サーバー上にファイルを保存する。(Unicode)

FtpPutFileW hConnect, lpszLocalFile, lpszNewRemoteFile, dwFlags, dwContext

hConnect : [intptr] FTP セッションへのハンドル。
lpszLocalFile : [wstr] ローカルシステムから送信するファイルの名前を格納した null 終端文字列へのポインタ。
lpszNewRemoteFile : [wstr] リモートシステム上に作成するファイルの名前を格納した null 終端文字列へのポインタ。
dwFlags : [int] 転送が発生する条件。アプリケーションは 1 つの転送種別と、ファイルのキャッシュ方法を制御するフラグの任意の組み合わせを選択すべきである。
dwContext : [int] 本検索を任意のアプリケーションデータと関連付けるアプリケーション定義の値を格納した変数へのポインタ。本パラメータは、アプリケーションが既に InternetSetStatusCallback を呼び出してステータスコールバックを設定している場合にのみ使用される。

(プラグイン / モジュール : wininet.dll)

解説

FTP サーバー上にファイルを保存する。(Unicode)

[戻り値]
成功した場合は TRUE を、失敗した場合は FALSE を返す。具体的なエラーメッセージを取得するには GetLastError
を呼び出す。

[備考]
FtpPutFile は、ローカルでのファイル読み取りと FTP
サーバーへの保存に伴うすべての管理処理を扱う高レベルなルーチンである。ファイルデータの送信のみを必要とする、またはファイル転送の細かな制御を必要とするアプリケーションは、FtpOpenFile
と InternetWriteFile 関数を使用すべきである。dwFlags パラメータに
FILE_TRANSFER_TYPE_ASCII
を指定すると、ファイルデータの変換により制御文字や書式文字がローカルの相当する文字に変換される。lpszNewRemoteFile と
lpszLocalFile の両方には、カレントディレクトリからの部分修飾または完全修飾のファイル名を指定できる。WinINet API
の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは FtpPutFile をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報