IWiaItem2::CreateChildItem method

Create a new child item. Adds IWiaItem2 objects to a device's IWiaItem2 tree.

Syntax

HRESULT CreateChildItem(
  [in]  LONG      lItemFlags,
  [in]  LONG      lCreationFlags,
  [in]  BSTR      bstrItemName,
  [out] IWiaItem2 **ppIWiaItem2
);

Parameters

lItemFlags [in]

Type: LONG

Specifies the WIA 2.0 item type. See WIA Item Type Flags.

lCreationFlags [in]

Type: LONG

Specifies how to create the new item.

0 (0)

Set the default values for the properties of the child.

COPY_PARENT_PROPERTY_VALUES (0x40000000)

Copy the values of all Read/Write properties from the parent.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Some WIA 2.0 hardware devices allow applications to create new items in the IWiaItem2 tree that represents the device. Applications must test the devices to see if they support this capability. Use the IEnumWIA_DEV_CAPS interface to enumerate the current device's capabilities.

If the device allows the creation of new items in the IWiaItem2 tree, invoking IWiaItem2::CreateChildItem creates a new IWiaItem2 object that is a child of the current node. It passes a pointer to the new node to the application through the ppIWiaItem2 parameter. Applications must call the IUnknown::Release method on the interface pointers they receive through the ppIWiaItem2 parameter.

If lCreationFlags is COPY_PARENT_PROPERTY_VALUES and lItemFlags is zero, the function returns E_INVALIDARG.

Requirements