L_WiaFreeItem

#include "ltwia.h"

L_LTWIA_API L_INT EXT_FUNCTION L_WiaFreeItem(hSession, pItem)

Frees the items enumerated by the L_WiaEnumChildItems function.

Parameters

HWIASESSION hSession

Handle to an existing WIA session. This handle is obtained by calling the L_WiaInitSession function.

L_VOID * 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

Value	Meaning
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

LEADTOOLS WIA supports both 32-bit and 64-bit image acquisition for both WIA 1.0 (XP and earlier) and WIA 2.0 (VISTA and later).