IRangeList::AddRange method

[IRangeList::AddRange is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Adds a range of values to the message range list.

Syntax

HRESULT AddRange(
  [in] const ULONG low,
  [in] const ULONG high
);

Parameters

low [in]

Type: const ULONG

Specifies a ULONG that contains the low number of the range to add to the range list.

high [in]

Type: const ULONG

Specifies a ULONG that contains the high number of the range to add to the range list.

Value	Meaning
RL_LAST_MESSAGE ((ULONG)-1)	Equivalent to "*" in an IMAP range list.

Return value

Type: HRESULT

Returns one of the following values.

Return code	Description
S_OK	Indicates success.
E_INVALIDARG	Indicates that the range list is empty.
E_OUTOFMEMORY	Indicates that an attempt to allocate memory failed.

Remarks

For example, AddRange(19,99) adds the values 19 through 99 to the range list.

Requirements

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