Share via


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