FILEIO Subroutine

Obtains the a unique temporary Filename.

 

call GetTempFileName(Directory_SV,

                     Prefix_SV,

                     FileName_SV)

Parameters

Directory_SV

A string containing the directory where the temporary file is to be located.

Prefix_SV

A string containing a three character prefix for the temporary. Strings longer than 3 characters will be truncated.

FileName_SV

A string which receives the name, with full path, of the temporary file.

Description

Use this routine to determine a unique name for a temporary file. The routine creates an empty file, so the file should be deleted even if ESL does not later use the file.

Errors

FIO_E_INVALIDPATH

The specified path does not exist.

FIO_E_BADFILENAME

The syntax of the path is not valid.

FIO_E_NAMEERROR

The syntax of the prefix is not valid.

FIO_E_INVALIDNAME

A directory within the path is invalid.

FIO_E_PATHTOOLONG

The directory path is too long to generate a filename.

See Also

GetTempPath( ) subroutine.

DeleteFile( ) subroutine.