Share via


FtpRenameFile

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function renames a file stored on the FTP server.

Syntax

BOOL WINAPI FtpRenameFile(
  HINTERNET hConnect, 
  LPCTSTR lpszExisting, 
  LPCTSTR lpszNew
);

Parameters

  • hConnect
    [in] Valid handle to an FTP session.
  • lpszExisting
    [in] Long pointer to a null-terminated string that contains the file name to be changed on the remote FTP server.
  • lpszNew
    [in] Long pointer to a null-terminated string that contains the new name for the remote file.

Return Value

TRUE indicates success. FALSE indicates failure. To get extended error data, call GetLastError.

Remarks

The lpszExisting and lpszNew parameters can be either partially or fully qualified file names relative to the current directory. A backward slash (\) or forward slash (/) can be used as the directory separator for either name. FtpRenameFile translates the directory name separators to the appropriate character before they are used.

Requirements

Header wininet.h
Library wininet.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

WinInet Functions