FtpRenameFileA 関数 (wininet.h)

  • [アーティクル]

FTP サーバーに格納されているファイルの名前を変更します。

構文

BOOL FtpRenameFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszExisting,
  [in] LPCSTR    lpszNew
);

パラメーター

[in] hConnect

FTP セッションへの処理。

[in] lpszExisting

名前を変更するファイルの名前を含む null で終わる文字列へのポインター。

[in] lpszNew

リモート ファイルの新しい名前を含む null で終わる文字列へのポインター。

戻り値

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

解説

lpszExisting パラメーターと lpszNew パラメーターには、現在のディレクトリに対するファイル名の一部または完全修飾名を指定できます。

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

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

注意

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

要件

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

関連項目

FTP セッション

WinINet 関数