IOEEnumRules::Next method

[IOEEnumRules::Next is no longer available for use as of Windows Vista.]

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

Syntax

HRESULT Next(
  [in]  ULONG   cpIRule,
  [out] IOERule **rgpIRule,
  [out] ULONG   *pcpIRuleFetched
);

Parameters

cpIRule [in]

Type: ULONG

Specifies a ULONG that indicates the number of requested elements.

rgpIRule [out]

Type: IOERule**

Receives the address of a pointer to the array of retrieved IOERule objects. The client is responsible for releasing these objects.

pcpIRuleFetched [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 cpIRule.
S_FALSE	Indicates that the method retrieved fewer than the number of elements specified by cpIRule.
E_OUTOFMEMORY	Indicates that an attempt to allocate memory failed.

Requirements

Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
End of client support	Windows XP
End of server support	Windows Server 2003
Product	Outlook Express 6.0
IDL	Oerules.idl
DLL	Msoe.dll (version 6.0 or later)