acrxLockApplication

C++

bool acrxLockApplication(
    void* appId
);

File

rxregsvc.h

Description

This function is a "C" code wrapper for:

acrxDynamicLinker->lockApplication(appId);

which locks an application, thus preventing it from being unloaded until it is either unlocked or AutoCAD shuts down.

The appId argument is the void pointer 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 pointer passed into acrxEntryPoint() during the AcRx::kInitAppMsg call is valid for this function. So, if this function will be called at any other time, the void pointer passed in during the AcRx::kInitAppMsg call must be stored for later use.

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

Parameters