Developer

API Reference

IResFile_Open()

Brew Release
Brew MP 1.0.2
See Also
IResFile Interface IResFile_GetNamed() IResFile_GetNamedObject() IResFile_GetNamedId() IResFile_GetObject() IResFile_Get()
Description
Opens a given resource file.
Parameters
  • pif
    []:
    [in] A pointer to an IResFile object.
  • f
    []:
    [in] The name of the resource file to open

Interface
Prototype
   int IResFile_Open(IResFile *pif, const char *f)
Return
   AEE_SUCCESS:       At least 1 file was successfully opened
   AEE_EFILEOPEN:     Given IResFile is already opened
   AEE_EFILENOEXISTS: Given file name does not exist
   AEE_EBADFILENAME:  Given filename is invalid
Side Effect
Associates the IResFile instance with the given resource file(s). Subsequent resource access functions will use the given resource file to load resources.
This function accepts multiple resource files, each of which will be opened and used as a search path on future resource accesses. Files are separated by semicolons.
For example:
   IResFile_Open(pRes, "customtheme.bar;basetheme.bar");

This will initialize both resource files for access. Future access functions will start with "customtheme.bar", followed by "basetheme.bar", returning the first valid entry found.
See IResFile access functions for more information.
Comment
None
  • Follow