Initializing and Freeing Containers

LEADTOOLS accesses containers through the CONTAINERHANDLE structure. This structure provides a working area for the LEADTOOLS container functions. The container handle must be initialized before calling any of the container functions. This is done using the LContainer::Initialize function. When the CONTAINERHANDLE structure is no longer needed, it should be freed using the LContainer::Free function.

A container handle is valid only after LContainer::Initialize and LContainer::Create have been called. The validity of a container handle should be checked before calling any other container functions. This is done using LContainer::IsValid. For more information on creating containers, refer to Creating a Container.