IProgressItems::ProgressItemFromBlock method (imapi2fs.h)

Retrieves a progress item based on the specified block number.

Syntax

HRESULT ProgressItemFromBlock(
  [in]  ULONG         block,
  [out] IProgressItem **item
);

Parameters

[in] block

Block number of the progress item to retrieve. The method returns the progress item if the block number is in the first and last block range of the item.

[out] item

An IProgressItem interface associated with the specified block number.

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
E_INVALIDARG	One or more arguments are not valid. Value: 0x80070057

Requirements

Requirement	Value
Minimum supported client	Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	imapi2fs.h

See also

IProgressItem

IProgressItems

IProgressItems::ProgressItemFromDescription

IProgressItems::get_Item