IMimeEnumAddressTypes::Next method

Article
05/31/2018

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

Syntax

HRESULT Next(
  [in]      ULONG          cFetch,
  [in, out] LPADDRESSPROPS prgAdr,
  [out]     ULONG          *pcFetched
);

Parameters

cFetch [in]

Type: ULONG

Specifies a ULONG that indicates the number of requested elements.

prgAdr [in, out]

Type: LPADDRESSPROPS

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

pcFetched [out]

Type: ULONG*

Receives a pointer to a ULONG that contains the number of elements that were actually 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)

Partager via