CFtpConnection::Rename

Call this member function to rename the specified file on the connected server.

BOOL Rename(
   LPCTSTR pstrExisting,
   LPCTSTR pstrNew 
);

Parameters

  • pstrExisting
    A pointer to a string containing the current name of the file to be renamed.

  • pstrNew
    A pointer to a string containing the file's new name.

Return Value

Nonzero if successful; otherwise 0. If the call fails, the Win32 function GetLastError may be called to determine the cause of the error.

Remarks

The pstrExisting and pstrNew parameters can be either a partially qualified filename relative to the current directory or fully qualified. A backslash (\) or forward slash (/) can be used as the directory separator for either name. Rename translates the directory name separators to the appropriate characters before they are used.

Requirements

Header: afxinet.h

See Also

Reference

CFtpConnection Class

Hierarchy Chart

CInternetConnection Class

Other Resources

CFtpConnection Members