LEADTOOLS accesses automation through the AUTOMATIONHANDLE structure. This structure provides a working area for the LEADTOOLS automation functions. This automation handle must be initialized before calling any of the automation functions. This is done using the L_AutInit function. The following example shows how to initialize the Automation handle:
/*Automation handle variable*/
/* initiate the Automation */
After initializing an Automation handle, the user must create the automation handle, based on the type of automation handle needed. To create a vector automation handle, call L_AutCreate with the nMode parameter set to AUTOMATION_MODE_VECTOR.
When the AUTOMATIONHANDLE structure is no longer needed, it should be freed using the L_AutFree function. The following is an example that shows how to free an automation handle:
if (SUCCESS == L_AutIsValid(pAutomation)) /* check the validity of the Automation handle */
/* free the Automation handle */
An automation handle is valid only after L_AutInit and L_AutCreate have been called. The validity of an automation handle should be checked before calling any other automation functions. This is done using L_AutIsValid.