Preparing for Unloading

When your application is unloaded, you must clean up any custom classes or commands that your application has created. This should take place in the AcRx::kUnloadAppMsg case of your acrxEntryPoint() function, or in a function called from that case.

To unload an ObjectARX application

1. If you have created commands with the acedRegCmds macro or acedDefun(), remove them.

   Usually ObjectARX commands are removed by groups, using acedRegCmds->removeGroup().

2. If you have created custom classes, remove them.

   Use the deleteAcRxClass() function to remove your custom classes from the AcRx runtime tree. Classes must be removed starting with the leaves of derived classes first, working up the class tree to parent classes.

3. Delete any objects added by the application.

   There is no way to tell AutoCAD to forget about AcDbObject instances that are currently resident in a database. However, when an application is unloaded, AutoCAD will automatically turn such objects into instances of AcDbProxyObject or AcDbProxyEntity.

4. Remove any reactors that have been attached to any AcDbObject, AcDbDatabase, AcRxDynamicLinker, or AcEditor object. (Persistent reactors on AcDbObjects are an exception; they will become proxy objects when the application is unloaded.)
5. If you have created a service name, remove it.

   You can use the acrxServiceDictionary->remove() function to remove any service that your application has registered. See the listing for acrxServiceDictionary in the ObjectARX Reference.