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 つの転送の種類と、ファイルのキャッシュの制御方法を制御するフラグのいずれかを選択する必要があります。
転送の種類には、次のいずれかの値を指定できます。
ファイルのキャッシュを制御するには、次の値を使用します。 アプリケーションでは、次の値のうち 1 つ以上を使用できます。
[in] dwContext
この検索を任意のアプリケーション データに関連付けるアプリケーション定義値を含む変数へのポインター。 このパラメーターは、アプリケーションが既に InternetSetStatusCallback を 呼び出して状態コールバックを設定している場合にのみ使用されます。
戻り値
成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 特定のエラー メッセージを取得するには、 GetLastError を呼び出します。
注釈
FtpPutFile は、ファイルをローカルで読み取って FTP サーバーに格納することに関連するすべての簿記とオーバーヘッドを処理する高レベルのルーチンです。 ファイル データのみを送信する必要があるアプリケーション、またはファイル転送を厳密に制御する必要があるアプリケーションでは、 FtpOpenFile 関数と InternetWriteFile 関数を使用する必要があります。
dwFlags パラメーターでFILE_TRANSFER_TYPE_ASCIIが指定されている場合、ファイル データの変換により、コントロール文字と書式設定文字がローカルの同等の文字に変換されます。
lpszNewRemoteFile と lpszLocalFile の両方に、現在のディレクトリに対する相対ファイル名を部分的または完全修飾にすることができます。
WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
注意
wininet.h ヘッダーは、FTPPutFile をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |