MappFree

Free an application.

Syntax

void MappFree(
    AIL_ID ContextAppId  //in
)

Description

This function deallocates an Aurora Imaging Library application previously allocated with MappAlloc.

MappFree must be the last function called; no other function can be executed after a call to this function. Prior to freeing an application, ensure that all systems, buffers, displays, and digitizers allocated in the application are freed, unless M_UNIQUE_ID was specified during allocation.

Note, if you use MappAllocDefault to allocate the default application, you must use MappFreeDefault to free the application.

Parameters

ContextAppId (in, AIL_ID)

Specifies the identifier of the application context to free.

Remarks

If you are creating a DLL that includes a call to MappFree, ensure that the call is not made from the DllMain() function, because MappFree might unload any DLL loaded with MappAlloc and you cannot unload a DLL from DllMain(). If necessary, call MappFree from a clean-up function in your DLL instead.