DFileSystemImageEvents::Update method (imapi2fs.h)

Implement this method to receive progress notification of the current write operation. The notifications are sent when copying the content of a file or while adding directories or files to the file system image.

Syntax

HRESULT Update(
  [in]  IDispatch *object,
  [in]  BSTR      currentFile,
  [in]  LONG      copiedSectors,
  [out] LONG      totalSectors
);

Parameters

[in] object

An IFileSystemImage interface of the file system image that is being written.

This parameter is a CFileSystemImage object in a script.

[in] currentFile

String that contains the full path of the file being written.

[in] copiedSectors

Number of sectors copied.

[out] totalSectors

Total number of sectors in the file.

Return value

Return values are ignored.

Remarks

Notifications are sent in response to calling one of the following methods:

• IFsiDirectoryItem::Add
• IFsiDirectoryItem::AddFile
• IFsiDirectoryItem::AddTree

Notifications can also be sent when calling one of the following methods to import a UDF file system that was created using immediate allocation (immediate allocation means that the file data is contained within the file descriptor instead of having allocation descriptors in the file descriptor that point to sectors of data):

• IFileSystemImage::ImportFileSystem
• IFileSystemImage::ImportSpecificFileSystem

Notification is sent:

• Once before adding the first sector of a file (copiedSectors is 0)
• For every megabyte that is written
• Once after the final write if the file did not end on a megabyte boundary

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

DFileSystemImageEvents