PDynaLink Class Reference

#include <dynalink.h>

Inheritance diagram for PDynaLink:


DLL entry point functions
typedef void(*	Function )()
	Primitive pointer to a function for a dynamic link module.
BOOL	GetFunction (PINDEX index, Function &func)
BOOL	GetFunction (const PString &name, Function &func)
Load/Unload function
virtual BOOL	Open (const PString &name)
virtual void	Close ()
virtual BOOL	IsLoaded () const
virtual PString	GetName (BOOL full=FALSE) const
static PString	GetExtension ()
Public Member Functions
Construction
	PDynaLink ()
	PDynaLink (const PString &name)
	~PDynaLink ()
Protected Attributes
void *	dllHandle
PString	name

Detailed Description

A dynamic link library. This allows the loading at run time of code modules for use by an application.

Member Typedef Documentation

typedef void(* PDynaLink::Function)()

Primitive pointer to a function for a dynamic link module.

Constructor & Destructor Documentation

PDynaLink::PDynaLink ( )

Create a new dyna-link, loading the specified module. The first, parameterless, form does load a library.

PDynaLink::PDynaLink ( const PString & name )

Create a new dyna-link, loading the specified module. The first, parameterless, form does load a library.
Parameters:

name Name of the dynamically loadable module.

PDynaLink::~PDynaLink ( )

Destroy the dyna-link, freeing the module.

Member Function Documentation

virtual void PDynaLink::Close ( ) [virtual]

Close the dyna-link library.

static PString PDynaLink::GetExtension ( ) [static]

Get the extension used by this platform for dynamic link libraries.

Returns:
String for file extension.

BOOL PDynaLink::GetFunction ( const PString & name,

Function & func

)

Get a pointer to the function in the dynamically loadable module.

Returns:
TRUE if function was found.

Parameters:

name Name of the function to get.

func Refrence to point to function to get.

BOOL PDynaLink::GetFunction ( PINDEX index,

Function & func

)

Get a pointer to the function in the dynamically loadable module.

Returns:
TRUE if function was found.

Parameters:

index Ordinal number of the function to get.

func Refrence to point to function to get.

virtual PString PDynaLink::GetName ( BOOL full = FALSE ) const [virtual]

Get the name of the loaded library. If the library is not loaded this may return an empty string.
If #full# is TRUE then the full pathname of the library is returned otherwise only the name part is returned.

Returns:
String for the library name.

Parameters:

full Flag for full or short path name