LInetFtp::RenameFile

#include "ltwrappr.h"

L_INT LInetFtp::RenameFile(pszOldName, pszNewName)

L_TCHAR *pszOldName;	/* old file name */
L_TCHAR *pszNewName;	/* new file name */

Renames a file stored on the FTP server.

Parameter	Description
pszOldName	Character string that contains the name of the file that will have its name changed on the remote FTP server. This is a NULL-terminated string.
pszNewName	Character string that contains the new name for the remote file. This is a NULL-terminated string.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

If the file specified in pszNewName already exists, this function will fail.

Required DLLs and Libraries

LTFIL
LTWEB

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:	LInetFtp::SendFile, LInetFtp::GetFile, LInetFtp::RemoveFile, Class Members
Topics:	FTP Functions: Remote File Operations
	How to Program with the LInetFtp Class

Example

This example renames a remote file on an FTP server.

L_INT LInetFtp_RenameFileExample(HWND hWndParent, L_TCHAR *pszOld, L_TCHAR *pszNew)
{
   L_INT nRet;
   LInetFtp InetFtp(TEXT("www.leadtools.com"));
   // Checking if the connection failed
   nRet = InetFtp.GetErrorFromList ();
   if(nRet != SUCCESS)
   {
      InetFtp.DisplayError (hWndParent, TEXT("Can't connect to the FTP server"));
      return nRet;
   }
   nRet = InetFtp.RenameFile(pszOld, pszNew);
   if(nRet != SUCCESS)
   {
      InetFtp.DisplayError(hWndParent, TEXT("Can't rename a remote file, an error within the server"));
      return nRet;
   }
   return SUCCESS;
}