IFileSystemImage::CreateResultImage method (imapi2fs.h)

Article
10/13/2021

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