Available in LEADTOOLS Imaging Pro, Vector, Document, and Medical Imaging toolkits. |
L_WiaFreeItem
#include "ltwia.h"
L_LTWIA_API L_INT EXT_FUNCTION L_WiaFreeItem(hSession, pItem)
HWIASESSION hSession; |
/* handle to an existing WIA session */ |
L_VOID * pItem; |
/* pointer to IWiaItem or IWiaItem2 interface */ |
Frees the items enumerated by the L_WiaEnumChildItems function.
Parameter |
Description |
hSession |
Handle to an existing WIA session. This handle is obtained by calling the L_WiaInitSession function. |
pItem |
Pointer to a type IWiaItem or IWiaItem2 object(IWiaItem if using WIA Version 1.0, IWiaItem2 if using WIA Version 2.0), that was retrieved through the LWIAENUMITEMSCALLBACK when the device's child items were enumerated. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This feature is available in version 16 or higher.
It is the user's responsibility to free the items enumerated by the L_WiaEnumChildItems function through the LWIAENUMITEMSCALLBACK function. To do so, call the L_WiaFreeItem function for each item enumerated through the callback mentioned above.
Note: This function is called internally by L_WiaAcquireSimple.
Required DLLs and Libraries
LTWIA For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Platforms
Earlier and later operating systems than Windows XP for WIA Version 1.
Windows VISTA or later for WIA Version 2.
See Also
Functions: |
L_WiaEnumChildItems, L_WiaGetRootItem, L_WiaInitSession, L_WiaEndSession. |
Topics: |
|
|
Example
For an example, refer to L_WiaGetRootItem.