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.

Functions:	L_WiaEnumChildItems, L_WiaGetRootItem, L_WiaInitSession, L_WiaEndSession.
Topics:	Managing WIA Sources
	WIA Functionality: Property Functions