PLUSLIB DLL Library

DLL Library Conventions

 

To have PxPlus use a DLL library, it must exist in the same directory as the pxplus.exe program. The Maintenance utility '*plus/dll/maint' provided with PxPlus is used to build a DLL library. The DLL will contain the PxPlus programs and data files that you need for your application as Windows Resources. See Maintenance Utility.

During system initialization, PxPlus will open the DLL and build a list of the files/programs that it contains. Whenever your application references any of the files contained within the library, the version in the library will be used, regardless of the value set in the PREFIX directive.

Note:
File names within the library are case insensitive, and all slashes will be converted to a forward slash.

To determine if the program/file is being accessed from the DLL library, the full pathname for the program/file will contain "[res]" as a prefix.

Single DLL Library

The Maintenance utility '*plus/dll/maint' is used to create a single resource DLL library. See Maintenance Utility. For PxPlus to use the DLL library, it must be named 'PLUSLIB.DLL'.

Multiple DLL Libraries

One additional resource library can be referenced within the [Config] section of the PxPlus INI file using the ResourceLib=lib.dll setting.

Example:

[Config]
ResourceLib=yourlib.dll

Up to 10 additional resource libraries can be referenced by using the 'OPTION' mnemonic (the "ResourceLib" setting). In the example below, each DLL is separated by a ; (semi-colon):

Example:

PRINT 'OPTION'("ResourceLib","lib1.dll";"lib2.dll";"lib3.dll")

Note:
The PLUSLIB.DLL is required when using multiple resource libraries. The PLUSLIB.DLL library can contain PxPlus programs and data files, or it can be empty.

(Multiple libraries support was added in PxPlus v11.)