int IMAPI ImgPlugInHostLoad (lpPlugInDir )

This function tells ImageMan to load the plug-in host module. The host must be loaded before any other ImageMan plug-in calls can be made successfully (with the exception of ImgPlugInHostIsAvailable and ImgPlugInHostIsEnabled).

 

Parameter	Type	Description
lpPlugInDir	LPSTR	Indicates the directory where the host can find all the plug-ins to use.

 

Return Value

Returns IMG_OK if successful, otherwise IMG_ERR. Use ImgGetStatus() to find out what may have caused the host load failure.

Comments

This function may also set the status to IMGPI_ALREADYLOADED if the host was already loaded. This does not cause any harm and can be ignored if you want. Only one copy of the host will be loaded in any event.

 

You can call ImgPlugInHostIsEnabled to check if the host is already loaded before making this call.

Example

int iErr = IMG_OK ;

if ( ImgPlugInHostIsAvailable() )

if ( ImgPlugInHostIsEnabled() )

iErr = ImgPlugInHostLoad (  c:\ImageMan\FFPlugins ) ;

if ( iErr != IMG_OK )

ImgErrBox() ;

// tell us what happened!!!

 

 

---

Copyright 2008 Data Techniques, Inc. All Rights Reserved