IFileSystemImage::put_FreeMediaBlocks method (imapi2fs.h)

Sets the maximum number of blocks available for the image.

Syntax

HRESULT put_FreeMediaBlocks(
  [in] LONG newVal
);

Parameters

[in] newVal

Number of blocks to use in creating the file system image.

By default, 332,800 blocks are used to create the file system image. This value assumes a capacity of 74 minutes of audio per 650MB disc.

To specify an infinite number of block, set newVal to zero.

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
IMAPI_E_IMAGE_TOO_BIG
Value specified for FreeMediaBlocks property is too small for estimated image size based on current data.

Value: 0xC0AAB121

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

IFileSystemImage

IFileSystemImage::get_FreeMediaBlocks