IWiaItem::DeleteItem method (wia_xp.h)

The IWiaItem::DeleteItem method removes the current IWiaItem object from the object tree of the device.

Syntax

HRESULT DeleteItem(
  [in] LONG lFlags
);

Parameters

[in] lFlags

Type: LONG

Currently unused. Should be set to zero.

Return value

Type: HRESULT

This method returns S_OK regardless of how many items were deleted. If the method fails, it returns a standard COM error code.

Remarks

The Windows Image Acquisition (WIA) run-time system represents each WIA hardware device connected to the user's computer as a hierarchical tree of IWiaItem objects. A given WIA device may or may not allow applications to delete IWiaItem objects from its tree. Use the IEnumWIA_DEV_CAPS interface to query the device for item deletion capability.

If the device supports item deletion in its IWiaItem tree, invoke the IWiaItem::DeleteItem method to remove the IWiaItem object. Note that this method will only delete an object after all references to the object have been released.

Requirements