PegasusLoad

The PegasusLoad function explicitly loads a specific AIMTools opcode library.

This function is not applicable on iOS. Opcode libraries can only be statically linked on iOS.

	Copy Code
*LONG PegasusLoad(OPERATION Op,* LONG ParmVer, char PICFAR* Path)**

Parameters:

Name	Description
Op	Specifies the opcode library to be loaded.
ParmVer	Specifies the version of the library to load, ordinarily CURRENT_PARMVER.
Path	Specifies the directory location from which to load the library. If the application specifies 0 for the path, then the opcode library is explicitly loaded using the same directory search order as when it is implicitly loaded (see Notes, below).

Return Value:

The return value is ERR_NONE if able to load the requested library, otherwise an error value defined in ERRORS.H is returned.

Notes:

An AIMTools opcode library is ordinarily implicitly loaded the first time Pegasus is called for the opcode and is unloaded when the application terminates. The implicit load searches the directories within the LD_LIBRARY_PATH environment variable for the library.

Using PegasusLoad allows an application a way to directly specify the directory containing the opcode library. It also allows the opcode library to be loaded at a time when error-handling may be more convenient, in case the library can't be loaded. An application is not required to call the PegasusUnload function after calling PegasusLoad, nor is an application required to call PegasusLoad before calling PegasusUnload.