LWia::SetPropertyGUID

Summary

Sets type VT_CLSID properties (like WIA_IPA_FORMAT).

Syntax

#include "ltwrappr.h"

virtual L_INT LWia::SetPropertyGUID(pItem, pszID, uID, pGuidValue)

Parameters

L_VOID * pItem

Valid pointer to a type IWiaItem (WIA Version 1.0) or IWiaItem2 (WIA Version 2.0) object, representing the item that is having the property.

Retrieve this parameter by either calling the LWia::GetRootItem function to get a pointer to the device's root item, or by enumerating the child items of the device by calling LWia::EnumChildItems.

L_TCHAR * pszID

String pointer containing the equivalent property ID string for the WIA property ID (see example below):

Property ID Property ID Equivalent String
WIA_IPA_TYMED WIA_IPA_TYMED_STR or "Media Type"
WIA_IPA_DEPTH WIA_IPA_DEPTH_STR or "Bits Per Pixel"

If this parameter is NULL, the WIA toolkit uses the ID passed through the uID parameter; otherwise, the pszID parameter id used regardless of whether a valid property ID has been passed through the uID parameter.

L_UINT32 uID

The property ID of the property.

This parameter is required only if the pszID parameter is NULL; otherwise, you can pass 0 for this parameter.

GUID * pGuidValue

Pointer to a variable of type GUID containing the GUID property value to be set for the item specified by the pItem parameter.

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.

Call [LWia:SetPropertyGUID to set the GUID value for any property of type VT_CLSID (for example, (WIA_IPA_FORMAT).

Required DLLs and Libraries

See Also

Functions

Topics

Example

For an example, refer to LWia::GetPropertyGUID.

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++ Class Library Help

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