acrxUnlockApplication

C++

bool acrxUnlockApplication(
    void* appId
);

File

rxregsvc.h

Description

When ObjectARX applications are initially loaded, they are locked so they cannot be unloaded until AutoCAD shuts down. This function is a "C" code wrapper for:

acrxDynamicLinker->unlockApplication(appId);

which unlocks an application, thus making it unloadable at any time thereafter.

The appId argument is the void* passed in as the second parameter to the application's acrxEntryPoint() function during the AcRx::kInitAppMsg call that occurs when the application is initially loaded.

Only the void* passed into acrxEntryPoint() during the AcRx::kInitAppMsg call is valid to be used by this function. So, if this function will be called at any other time the void* passed in during the AcRx::kInitAppMsg call must be stored for later use.

Returns 1 if the application is successfully unlocked; otherwise, returns 0.

Parameters