home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 5 / Apprentice-Release5.iso / Source Code / C++ / Applications / PICSee Dust 1.01 / Quaternary Source / FileRegistry.h < prev    next >
Encoding:
C/C++ Source or Header  |  1995-11-11  |  1.2 KB  |  41 lines  |  [TEXT/CWIE]
  1. #ifndef FILEREGISTRY_H_
  2. #define FILEREGISTRY_H_
  3.  
  4. /*
  5.     File: FileRegistry.h, .cpp
  6.     by Hiep Dam
  7.     Date: Nov 11 95
  8.  
  9.     Opening and handling files is not as easy as the File and
  10.     Resource Manager may have you believe. Even though you
  11.     may specify an fsRdWrPerm permission code, if the file
  12.     is already opened by your application, you will get that
  13.     file's reference number again [which may not be what you
  14.     want]. So it is up to you to prevent users from opening
  15.     your file two or more times.
  16.     
  17.     Thus the file registry below. It keeps an internal list
  18.     of file reference numbers, which you can register. Once
  19.     you register it checks to see if the file reference
  20.     number is already in the registry (and thus already
  21.     opened). This makes things easier for you.
  22. */
  23.  
  24. // ---------------------------------------------------------------------------
  25.  
  26. /*
  27.     Pass the fileRefNum of the opened file to RegisterFile.
  28.     Returns true if file isn't in registry and has been added
  29.     to the registry. Returns false if file is in registry
  30.     already.
  31. */
  32. Boolean RegisterFile(short fileRefNum);
  33.  
  34. /*
  35.     Returns true if file was in registry and has been removed.
  36.     Returns false if file wasn't in registry to begin with.
  37. */
  38. Boolean UnregisterFile(short fileRefNum);
  39.  
  40.  
  41. #endif // FILEREGISTRY