ImgPlugInHostIsAvailable

BOOL IMAPI ImgPlugInHostIsAvailable ()

This function indicates whether or not the plug-in host is available. The plug-in host is available if ImageMan's main DLL can locate the host and successfully load it.

Return Value

Returns TRUE if the host is available (regardless of whether or not it is already loaded) or FALSE if it is not.

Comments

The ImageMan DLL determines plug-in host availability only once when the ImageMan DLL is loaded.

If you make the host available to the DLL while it is already loaded, you will need to restart your application so ImageMan will be reloaded and attempts to relocate and load the plug-in host module.

Example

int iErr = IMG_OK ;

if ( ImgPlugInHostIsAvailable() ) {

iErr = ImgPlugInHostLoad( c:\myplugindir ) ;

if ( iErr != IMG_OK )

ImgErrBox() ; // tell us what happened!

// or else you are ready for some plug-ins !!

}