Previous

Next

Function RTFMakeFileName

RTFMakeFileName builds a valid short file name from information found in a directory entry from a FAT volume:

int RTFMakeFileName(const RTFDOSDirEntry * FileInfo, char * FileName);

Parameters

FileInfo

Must point to a valid directory entry, which, for example, could have been read from a directory of a FAT volume.

FileName

Must point to a string buffer of at least 13 characters length to receive the file name.

return value

If the function succeeds, the return value is RTF_NO_ERROR and the file name is copied to *FileName. If the function fails, the return value is a negative error code.

If the RTF_ATTR_VOLUME attribute is set in FileInfo->Attributes, the file name built does not contain a period to separate name and extension. For other files, the period is present only if the extension is not blank. This function does not access any physical disks.

Note that structure RTFDOSDirEntry does not contain the information required to build a file's long name. To retrieve a long file name, use RTFGetFileInfoEx, RTFFindFirstEx, or RTFFindNextEx.

Please note that on exFAT and ISO 9660 volumes, no file name is stored in structure RTFDOSDirEntry. This function will return an error in this case. Please see section API Differences Between FAT and ISO 9660 and API Differences Between FAT and exFAT for details.

File Name Operations

Function RTFMakeTempFileName

Function RTFExpandName