IFileSystemImage::CreateResultImage method (imapi2fs.h)

Create the result object that contains the file system and file data.

Syntax

HRESULT CreateResultImage(
  [out] IFileSystemImageResult **resultStream
);

Parameters

[out] resultStream

An IFileSystemImageResult interface of the image result.

Client applications can stream the image to media or other long-term storage devices, such as disk drives.

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_INVALID_PARAM
The value specified for parameter %1!ls! is not valid.

Value: 0xC0AAB101

E_OUTOFMEMORY
Failed to allocate the required memory.

Value: 0x8007000E

Remarks

Currently, IFileSystemImage::CreateResultImage will require disc media access as a result of a previous IFileSystemImage::IdentifyFileSystemsOnDisc method call. To resolve this issue, it is recommended that another IFileSystemImage object be created specifically for the IFileSystemImage::IdentifyFileSystemsOnDisc operation.

The resulting stream can be saved as an ISO file if the file system is generated in a single session and has a start address of zero.

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_FileSystemsToCreate

IFileSystemImage::put_FileSystemsToCreate

IFilesystemImage::ChooseImageDefaults

IFilesystemImage::ChooseImageDefaultsForMediaType