wFSrename Function

MDD File System Interface Library

MDDFS Interface Library Help
wFSrename Function
C
int wFSrename(
    const unsigned short int * fileName, 
    FSFILE * fo
);
Description

Renames the name of the file or directory to the UTF16 input fileName on PIC24/PIC32/dsPIC devices. First, it will search through the current working directory to ensure the specified new UTF16 filename is not already in use. If it isn't, the new filename will be written to the file entry of the file pointed to by 'fo.'

Preconditions

File opened.

Parameters
Parameters 
Description 
fileName 
The new name of the file 
fo 
The file to rename 
Return Values
Return Values 
Description 
File was renamed successfully 
EOF 
File was not renamed 
Side Effects

The FSerrno variable will be changed.

Remarks

None

Microchip MDD File System Interface 1.4.2 - [Oct 15, 2012]
Copyright © 2012 Microchip Technology, Inc.  All rights reserved.