Initializing, Creating and Freeing Automation Handles
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*/
pAUTOMATIONHANDLE pAutomation ;
/* initiate the Automation */
L_AutInit ( pAutomation ) ;
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 */
L_AutFree ( pAutomation ) ;
return SUCCESS ;
}
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.
See Also