IWiaItem2::GetParentItem method

Gets the parent item in the tree that represents a Windows Image Acquisition (WIA) 2.0 hardware device.

Syntax

HRESULT GetParentItem(
  [out] IWiaItem2 **ppIWiaItem2
);

Parameters

ppIWiaItem2 [out]

Type: IWiaItem2**

Receives the address of a pointer to the IWiaItem2 interface of the parent of the item in the tree of item objects. If this method is called on the root of the tree, then the returned address is NULL.

Return value

Type: HRESULT

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

Remarks

Given any IWiaItem2 object in the object tree of a WIA 2.0 hardware device, the application retrieves a pointer to the parent item by calling this function.

Applications must call the IUnknown::Release method on the interface pointers they receive through the ppIWiaItem2 parameter if these pointers are not NULL.

Requirements