CFtpConnection::Rename

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

接続しているサーバーの指定したファイルの名前を変更します。

BOOL Rename(
   LPCTSTR pstrExisting,
   LPCTSTR pstrNew 
);

パラメータ

pstrExisting
名前を変更するファイルの現在の名前が入っている文字列へのポインタ。
pstrNew
ファイルの新しい名前が入っている文字列へのポインタ。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。呼び出しに失敗した場合は、Win32 の関数 GetLastError を呼び出してエラーの原因を調査できます。

解説

pstrExisting パラメータと pstrNew パラメータは、現在のフォルダに対する相対の部分的なファイル名、または完全なファイル名のどちらも可能です。円記号 (\) またはスラッシュ (/) を、それぞれの名前のフォルダ名の区切り記号として使用できます。Rename は、フォルダを使用する前に、フォルダ名の区切り記号を適切な文字に変換します。