IFileSystemImage::put_FileSystemsToCreate method (imapi2fs.h)

Article
10/13/2021

Sets the file systems to create when generating the result stream.

Syntax

HRESULT put_FileSystemsToCreate(
  [in] FsiFileSystems newVal
);

Parameters

[in] newVal

One or more file systems to create when generating the result stream. For possible values, see the FsiFileSystems enumeration type.

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
IMAPI_E_TOO_MANY_DIRS	This file system image has too many directories for the %1!ls! file system. Value: 0xC0AAB130
IMAPI_E_FILE_SYSTEM_CHANGE_NOT_ALLOWED	You cannot change the file system specified for creation, because the file system in the imported session and the one in the new session do not match. Value: 0xC0AAB163L
IMAPI_E_ISO9660_LEVELS	ISO9660 is limited to 8 levels of directories. Value: 0xC0AAB131
IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION	You cannot change the file system specified for creation, because the file system from the imported session and the file system in the current session do not match. Value: 0xC0AAB133
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED	This feature is not supported for the current file system revision. The image will be created without this feature. Value: 0x00AAB15FL

Remarks

This method returns IMAPI_E_INCOMPATIBLE_PREVIOUS_SESSION if the previous session was imported using IFileSystemImage::ImportFileSystem or IFileSystemImage::ImportSpecificFileSystem and the layout of that session is incompatible with the layout used by IMAPI for the file systems identified by the specified newVal in IFileSystemImage::put_FileSystemToCreate.

You can change the file system only when the result stream is not active.

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