Edit

IBlockRangeList::get_BlockRanges method (imapi2.h)

  • Article

Returns the list of sector ranges in the form of a safe array of variants of type VT_Dispatch.

Syntax

HRESULT get_BlockRanges(
  [out, retval] SAFEARRAY **value
);

Parameters

[out, retval] value

List of sector ranges. Each element of the list is a VARIANT of type VT_Dispatch. Query the pdispVal member of the variant for the IBlockRange interface.

Return value

S_OK is returned on success, but other success codes may be returned as a result of implementation. The following error codes are commonly returned on operation failure, but do not represent the only possible error values:

Return code Description
E_POINTER
 Pointer is not valid.

Value: 0x80004003
E_OUTOFMEMORY
 Failed to allocate the required memory.

Value: 0x8007000E

Remarks

The order of sector ranges in IBlockRangeList is taken into account during burning. The sector ranges having lower indexes in the safe array returned by IBlockRangeList::get_BlockRanges are written before those with higher indexes.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header imapi2.h

See also

IBlockRangeList