IEnumWIA_DEV_INFO::Next method (wia_xp.h)

Article
02/22/2024

The IEnumWIA_DEV_INFO::Next method fills an array of pointers to IWiaPropertyStorage interfaces.

Syntax

HRESULT Next(
  [in]      ULONG               celt,
  [out]     IWiaPropertyStorage **rgelt,
  [in, out] ULONG               *pceltFetched
);

Parameters

[in] celt

Type: ULONG

Specifies the number of array elements in the array indicated by the rgelt parameter.

[out] rgelt

Type: IWiaPropertyStorage**

Receives the address of an array of IWiaPropertyStorage interface pointers. IEnumWIA_DEV_INFO::Next fills this array with interface pointers.

[in, out] pceltFetched

Type: ULONG*

On output, this parameter contains the number of interface pointers actually stored in the array indicated by the rgelt parameter.

Return value

Type: HRESULT

While there are devices left to enumerate, this method returns S_OK. It returns S_FALSE when the enumeration is finished. If the method fails, it returns a standard COM error code.

Remarks

Applications use this method to query the properties of each available Windows Image Acquisition (WIA) hardware device. To do so, the application passes an array of IWiaPropertyStorage interface pointers that it allocates. It also passes the number of array elements in the parameter celt. The IEnumWIA_DEV_INFO::Next method fills the array with pointers to IWiaPropertyStorage interfaces. Applications can query the interfaces for the properties that the device supports.

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

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	wia_xp.h (include Wia.h)
Library	Wiaguid.lib

Share via