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:

Managing WIA Sources

 

WIA Functionality: Property Functions

Example

For an example, refer to L_WiaGetRootItem.