File Maintenance Functions 

PxIORenameFile

 

Description

Renames the specified file

Format

int PxIORenameFile(PxIOService service, const char *oldFilename, const char *newFilename, BOOL allSegmentsFlag);

Where:

service

A previously created PxIOService

oldFilename

Path and filename of the file to rename

newFilename

Path and filename to which the file is to be renamed

allSegmentsFlag

The flag indicates whether all segments of a multi-segmented file should be renamed

Return Value

If the function succeeds, a value of PXIO_SUCCESS_STATUS is returned; otherwise, an error value is returned. More information on the nature of the error can be found by calling PxIOGetError.

Note:
The service must be included for security purposes, and the pathname is relative to the service. For a remote service using PxServer, the path is relative to the machine on which PxServer is running.