LWia::EnumChildItems

Summary

Enumerates all available child items for the root item specified in the pWiaRootItem parameter.

Syntax

#include "ltwrappr.h"

virtual L_INT LWia::EnumChildItems(pWiaRootItem)

Parameters

L_VOID * pWiaRootItem

Valid pointer to a type IWiaItem or IWiaItem2 object (IWiaItem if using WIA Version 1.0 or IWiaItem2 if using WIA Version 2.0), representing the root item for which its child items are being enumerated.

Returns

Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.

Comments

This feature is available in LEADTOOLS version 16 or higher.

The WIA run-time system represents each WIA hardware device in a hierarchical tree of IWiaItem or IWiaItem2 objects (IWiaItem objects if WIA Version 1.0 is being used; IWiaItem2 objects if WIA Version 2.0 is being used). Use LWia::EnumChildItems in applications to enumerate the child items for the specified root item.

Be sure to pass a valid pWiaRootItem parameter. To do so, first retrieve a pointer to the device's root Item itself by declaring a variable pointer of type IWiaItem* or IWiaItem2*. Next, pass the address of that pointer to the third parameter of the LWia::GetRootItem function (do not forget to cast it to (L_VOID**)). Then pass this same declared variable (after LWia::GetRootItem fills it with a valid item) to LWia::EnumChildItems as the root item for which you wish to enumerate the child items.

Required DLLs and Libraries

See Also

Functions

Topics

Example

For an example, refer to LWia::GetRootItem.

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

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