Frees the automation handle.
#include "ltwrappr.h"
L_INT LAutomation::Free(void);
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
This function should be called when an automation handle is no longer needed by an application.
This example frees the automation handle and its associated toolbar (if one exists).
L_INT LAutomation_FreeExample(LAutomation &lauto)
{
L_INT nRet;
nRet = lauto.IsValid();
if ( SUCCESS == nRet ) /* check the validity of the automation handle */
{
LToolbar *pToolbar;
/* get the automation toolbar handle */
pToolbar = lauto.GetToolbar () ;
if ( NULL != pToolbar ) /* check if there is any toolbar is currently installed */
{
/* free the toolbar handle */
nRet = pToolbar->Free () ;
if(nRet != SUCCESS)
return nRet;
}
/* free the automation handle */
nRet = lauto.Free () ;
if(nRet != SUCCESS)
return nRet;
}
else
{
return nRet ;
}
return SUCCESS ;
}