IRangeList::Save method

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

Returns a copy of the internal message range list representation that can be loaded later by using the IRangeList::Load method.

Syntax

HRESULT Save(
  [out] byte  **ppbDestination,
  [out] ULONG *pulSizeOfDestination
);

Parameters

ppbDestination [out]

Type: byte**

Receives the address of a pointer to a copy of the internal range list.

pulSizeOfDestination [out]

Type: ULONG*

Receives a pointer to a ULONG that contains the size (in bytes) of the data pointed to by ppbDestination.

Return value

Type: HRESULT

Returns one of the following values.

Return code	Description
S_OK	Indicates success.
E_OUTOFMEMORY	Indicates that an attempt to allocate memory failed.

Remarks

Failure to allocate memory is typically the reason for failure.

[!Caution]
The internal range list representation is not suitable for network transmittal.

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)