Edit

Share via

IFileSystemImage::put_FileSystemsToCreate method (imapi2fs.h)

  • Article

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

See also

IFileSystemImage

IFileSystemImage::CreateResultImage

IFileSystemImage::get_FileSystemsToCreate