acrxUnloadApp

C++

bool acrxUnloadApp(
    const ACHAR * appName, 
    bool asCmd = false
);

File

rxregsvc.h

Description

This function is a "C" code wrapper for:

acrxDynamicLinker->unloadApp(appName);

which unloads the appName ObjectARX program. appName is the application name as set in the operating system registry. If the ObjectARX application was not loaded via the AcRxDynamicLinker::loadApp() or acrxLoadApp() method, or through the demand loading mechanism (all of which use the system registry entry for the application), then this function will be unable to unload the application.

When asCmd is false, it's possible to call this method more than once and still get a successful return value. This method will simply decrement the reference count for the application.

The asCmd value used for acrxUnloadApp() must be the same as the one used for acrxLoadApp().

The function returns 1 if the module was successfully found and unloaded, otherwise, it returns 0.

Parameters