NetRenameFile (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / Net functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

NetRenameFile (Function)

In french: NetRenommeFichier

Warning
This function is kept for backward compatibility. It is recommended to use a standard FTP, SSH or SCP server. For more details, see Handling files on an FTP server and Standard FTP functions.

Renames or moves a file located on the FTP (File Transfer Protocol) or RPC (Remote Procedure Call) server created with WINDEV.

Note: To enable or disable this function on an FTP/RPC server, use NetServerOption.

Example

Res is int
IDServeurFTP is int
IDServeurFTP = NetConnect("148.61.125.245", FTPServer, "GUEST", "")

// Renommer un fichier sur le serveur
Res = NetRenameFile(IDServeurFTP, "C:\HISTO\ANNEE98.TXT", ...
	"C:\HISTO\ANNEE98.BAK")
IF Res <> 0 THEN
	// Procédure de traitement de l'erreur
  	TraiteErreur() 
END

Syntax

<Result> = NetRenameFile(<Connection ID> , <Name of source file> , <Renamed file>)

<Result>: Integer

Result of the modification:
0: The file on the server has been renamed
2: The file to be renamed does not exist
5: Access denied
17: Prohibited movement from one disc to another
19: Write-protected diskette
32: The file is used by another program
183: A file with the same name already exists

<Connection ID>: Integer

Identifier of the connection for the client computer (returned by NetConnect).

<Name of source file>: ANSI character string

Name and full path of the file to rename on the server.

<Renamed file>: ANSI character string

Name and full path of the renamed file. If the path is different but the file name remains the same, the file will be moved (on the same disk only).

Component: wd300com.dll