Expand Minimize

IFileSystemImage interface

Use this interface to build a file system image, set session parameter, and import or export an image.

The file system directory hierarchy is built by adding directories and files to the root or child directories.

To create an instance of this interface, call the CoCreateInstance function. Use__uuidof(MsftFileSystemImage) for the class identifier and __uuidof(IFileSystemImage) for the interface identifier.

Members

The IFileSystemImage interface inherits from the IDispatch interface. IFileSystemImage also has these types of members:

Methods

The IFileSystemImage interface has these methods.

MethodDescription
ChooseImageDefaults

Sets the default file system types and the image size based on the current media.

ChooseImageDefaultsForMediaType

Sets the default file system types and the image size based on the specified media type.

get_ISO9660InterchangeLevel

Retrieves the ISO9660 compatibility level to use when creating the result image.

get_ISO9660InterchangeLevelsSupported

Retrieves the supported ISO9660 compatibility levels.

get_MultisessionInterfaces

Retrieves the list of multi-session interfaces for the optical media.

get_StageFiles

Determines if the file system should be staged before the burn.

get_UDFRevision

Retrieves the UDF revision level of the imported file system image.

put_ISO9660InterchangeLevel

Sets the ISO9660 compatibility level of the file system image.

put_MultisessionInterfaces

Sets the list of multi-session interfaces for the optical media.

put_UDFRevision

Sets the UDF revision level of the file system image.

CalculateDiscIdentifier

Retrieves a string that identifies a disc and the sessions recorded on the disc.

CreateDirectoryItem

Create a directory item with the specified name.

CreateFileItem

Create a file item with the specified name.

CreateResultImage

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

Exists

Checks for the existence of a given file or directory.

get_BootImageOptions

Retrieves the boot image that you want to add to the file-system image.

get_ChangePoint

Retrieves the change point identifier.

get_DirectoryCount

Retrieves the number of directories in the file system image.

get_FileCount

Retrieves the number of files in the file system image.

get_FileSystemsSupported

Retrieves the list of file system types that a client can use to build a file system image.

get_FileSystemsToCreate

Retrieves the types of file systems to create when generating the result stream.

get_FreeMediaBlocks

Retrieves the maximum number of blocks available for the image.

get_ImportedVolumeName

Retrieves the volume name provided from an imported file system.

get_Root

Retrieves the root directory item.

get_SessionStartBlock

Retrieves the starting block address for the recording session.

get_StrictFileSystemCompliance

Determines the compliance level for creating and developing the file-system image.

get_UDFRevisionsSupported

Retrieves a list of supported UDF revision levels.

get_UsedBlocks

Retrieves the number of blocks in use.

get_UseRestrictedCharacterSet

Determines if file and directory names should be restricted to using only CP_ANSI characters.

get_VolumeName

Retrieves the volume name for this file system image.

get_VolumeNameISO9660

Retrieves the volume name for the ISO9660 system image.

get_VolumeNameJoliet

Retrieves the volume name for the Joliet system image.

get_VolumeNameUDF

Retrieves the volume name for the UDF system image.

get_WorkingDirectory

Retrieves the temporary directory in which stash files are built.

GetDefaultFileSystemForImport

Retrieves the file system to import by default.

IdentifyFileSystemsOnDisc

Retrieves a list of the different types of file systems on the optical media.

ImportFileSystem

Imports the default file system on the current disc.

ImportSpecificFileSystem

Import a specific file system from disc.

LockInChangePoint

Locks the file system information at the current change-point level.

put_BootImageOptions

Sets the boot image that you want to add to the file-system image.

put_FileSystemsToCreate

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

put_FreeMediaBlocks

Sets the maximum number of blocks available for the image.

put_SessionStartBlock

Sets the starting block address for the recording session.

put_StageFiles

Determines if the file system should be staged before the burn.

put_StrictFileSystemCompliance

Determines the compliance level for creating and developing the file-system image.

put_UseRestrictedCharacterSet

Determines if file and directory names should be restricted to using only CP_ANSI characters.

put_VolumeName

Sets the volume name for this file system image.

put_WorkingDirectory

Sets the temporary directory in which stash files are built.

RollbackToChangePoint

Reverts the image back to the specified change point.

SetMaxMediaBlocksFromDevice

Set maximum number of blocks available based on the capabilities of the recorder.

 

Remarks

To create the CFileSystemImage object in a script, use IMAPI2.MsftFileSystemImage as the program identifier when calling CreateObject.

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

IDL

Imapi2fs.idl

See also

DFileSystemImageEvents

 

 

Community Additions

ADD
Show:
© 2014 Microsoft