IWiaItem2::GetRootItem method

Gets the root item of a tree of item objects used to represent a Windows Image Acquisition (WIA) 2.0 hardware device.

Syntax

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

Parameters

ppIWiaItem2 [out]

Type: IWiaItem2**

Receives the address of a pointer to the IWiaItem2 interface of the root item.

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 root item by calling this function.

Applications must call the IUnknown::Release method on the interface pointers they receive through the ppIWiaItem2 parameter.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Header	Wia.h
IDL	Wia.idl