IEnumWIA_FORMAT_INFO::Next method (wia_xp.h)

The IEnumWIA_FORMAT_INFO::Next method returns an array of WIA_FORMAT_INFO structures.

Syntax

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

Parameters

[in] celt

Type: ULONG

Specifies the number of elements requested.

[out] rgelt

Type: WIA_FORMAT_INFO*

Receives the address of the array of WIA_FORMAT_INFO structures.

[in, out] pceltFetched

Type: ULONG*

On output, receives the address of a ULONG that contains the number of WIA_FORMAT_INFO structures actually returned in the rgelt parameter.

Return value

Type: HRESULT

If the enumeration is continuing, this method returns S_OK and sets the value pointed to by pceltFetched to the number of capabilities returned. If the enumeration is complete, it returns S_FALSE and sets the value pointed to by pceltFetched to zero. If the method fails, it returns a standard COM error.

Requirements