Path Info

These functions are designed to permit a SAF client to obtain information about a named file without actually requiring the client to succesfully open the file with a call to saf_open_database. This is particularly useful for clients that need to be responsive to different versions of SAF databases.

All the functions in this part of the interface return information about the file identified in the saf_readInfo_path call and how that file was generated. The typical usage of these functions is to first obtain information about the given file with a call to saf_readInfo_path. Then, use the various query functions here to obtain specific information about the file name (path) passed into saf_readInfo_path and finally to free up any resources with a call to saf_freeInfo_path.