The PegasusUnload function explicitly unloads one or more of the PICTools opcode libraries.

Parameters:

Return Value:

This function does not return a value.

Notes:

Ordinarily the PICTools opcode libraries are implicitly unloaded when the application terminates.

Using PegasusUnload allows the application a method to explicitly unload a specific opcode library if desired. The use of PegasusUnload is always optional.  PegasusUnload does not have to be called if PegasusLoad is called and PegasusUnload can be called if PegasusLoad is not called.

The PICTools API library maintains a load count for each opcode library.  PegasusUnload must be called as many times as PegasusLoad was called in order for the library to be unloaded. If the opcode library were implicitly loaded by calling Pegasus without calling PegasusLoad, then the opcode library will be unloaded the first time PegasusUnload is called, regardless of how many times Pegasus may have been called.

It is not an error to call PegasusUnload while a Pegasus operation for the opcode is active.  The opcode library will be unloaded when the Pegasus operation is complete or terminated.

See Also

PegasusLoad