version 2003
PA_OpenResFile (fullPath) short
Parameter | Type | Description | |
fullPath | char* | Full path of the resource file to open | |
Function result | short | File reference number of the opened file |
Description
The routine PA_OpenResFile opens an Internal Resource File at location fullPath and returns its file reference number. If the file could not been opened (bad path, file in use, etc.), PA_OpenResFile returns -1.
If the file is already open in the same application, the routine returns its reference number.
If fullPath is not a valid resource file or does not refer to an existing file, PA_OpenResFile returns -1 and PA_GetLastError() returns the appropriate File Manager error.
For Windows users
4th Dimension adds the necessary .4DB file extension to the file name - simply pass the name of the new file.
Example
At startup, open a private resource file and set a global to this reference.
// "somewhare" short gMyResFile; // . . . gMyResFile = PA_OpenResFile(gMyResFileLocation);
See Also
PA_CreateResFile, PA_OpenResFile.
Error Handling
Use PA_GetLastError to see if an error occurred