IWiaDevMgr2::EnumDeviceInfo method

Creates an enumerator of property information for each available Windows Image Acquisition (WIA) 2.0 device.

Syntax

HRESULT EnumDeviceInfo(
  [in]          LONG              lFlags,
  [out, retval] IEnumWIA_DEV_INFO **ppIEnum
);

Parameters

lFlags [in]

Type: LONG

Specifies the type of WIA 2.0 devices to enumerate.

WIA_DEVINFO_ENUM_LOCAL

Only locally connected active scanner devices are enumerated.

WIA_DEVINFO_ENUM_ALL

All devices are enumerated, both locally and remote, including inactive (disconnected) devices and legacy STI-only devices.

ppIEnum [out, retval]

Type: IEnumWIA_DEV_INFO**

Receives the address of a pointer to the IEnumWIA_DEV_INFO interface.

Return value

Type: HRESULT

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

Remarks

The IWiaDevMgr2::EnumDeviceInfo method creates an enumerator object that supports the IEnumWIA_DEV_INFO interface. The method stores a pointer to the IEnumWIA_DEV_INFO interface in the parameter ppIEnum. Applications can use the IEnumWIA_DEV_INFO interface pointer to enumerate the properties of each WIA 2.0 device attached to the user's computer.

Applications must call the IUnknown::Release method on the interface pointers they receive through the ppIEnum 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