L_WiaFreeItem

Summary

Frees the items enumerated by the L_WiaEnumChildItems function.

Syntax

#include "ltwia.h"

L_LTWIA_API L_INT EXT_FUNCTION L_WiaFreeItem(hSession, pItem)

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

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).

See Also

Functions

Topics

Example

For an example, refer to L_WiaGetRootItem.

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS WIA C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.