IMimeEnumProperties::Next method

Retrieves the next specified number of elements in the enumeration sequence.

Syntax

HRESULT Next(
  [in]      ULONG          cFetch,
  [in, out] LPENUMPROPERTY prgProp,
  [out]     ULONG          *pcFetched
);

Parameters

cFetch [in]

Type: ULONG

Specifies a ULONG that indicates the number of requested elements.

prgProp [in, out]

Type: LPENUMPROPERTY

Receives an array of ENUMPROPERTY structures in which to store the retrieved elements. The array can be freed by calling FreeEnumPropertyArray.

pcFetched [out]

Type: ULONG*

Receives a pointer to a ULONG that contains the number of elements that were retrieved.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
Indicates that the method retrieved the number of elements specified by cFetch.
S_FALSE
Indicates that the method retrieved fewer than the number of elements specified by cFetch.
E_OUTOFMEMORY
Indicates that an attempt to allocate memory failed.

Remarks

If there are fewer than the requested number of elements remaining in the sequence, this method retrieves the remaining elements. The number of elements actually retrieved is returned through pcFetched (unless the caller passed in NULL for this parameter).

Requirements

Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Product
Outlook Express 6.0
Header
Mimeole.h
IDL
Mimeole.idl
DLL
Inetcomm.dll (version 6.0 or later)