Overview of Interface Libraries
The appropriate way to access the MicroKernel Engine from your Windows application is to link to a library that references the Btrieve Glue DLL when you compile. The Glue DLL is responsible for “glueing” your application to the Interface DLL. Like traditional glue (adhesive material), the Glue DLL is a thin layer between your application and the Interface DLL. The Glue DLL is responsible for successfully performing the following actions:
1
Loads the Interface DLL.
2
Binds to (that is, imports symbols from) the Interface DLL.
If the Glue DLL encounters a failure condition at any step, it issues an appropriate status code that your application can use to alert the user of the failure.
Table
31
shows the link libraries that your application can link with and the DLLs to load.
Table 31
MicroKernel Engine Programming Libraries
Operating System and Compiler
1
Glue DLL
Link Library
Windows 32-bit (Microsoft Visual C++, Watcom, Embarcadero)
W3BTRV7.DLL
W3BTRV7.LIB
Windows 64-bit
W64BTRV.DLL
W64BTRV.LIB
1
Compiler-specific libraries are in different subdirectories. To link Win32 applications, use the \Win32 directory if you use the Microsoft compiler; use the \Win32x directory if you use the Embarcadero or Watcom compiler.
Linux and OS X
Linux and OS X have no glue components. The application directly links against the shared library that implements the interface. The MicroKernel Engine link library is libpsqlmif for both Linux 32-bit and Linux and OS X 64-bit applications.