This function renames (and optionally moves) a file or directory.

Declaration:

AT_ERRCOUNT ACCUAPI IG_TWAIN_file_rename(
        LPCSTR lpszOldName,
        LPCSTR lpszNewName
);

Arguments:

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

Absolute and relative path names are supported. A file may not be overwritten with this command. If an Application wishes to do this, it must first delete the unwanted file, then issue the rename command. Filenames in the root directory cannot be moved or renamed.

Use IG_TWAIN_source_open() to select the desired Data Source.