IFileSystemImage::RollbackToChangePoint method (imapi2fs.h)

Article
10/13/2021

Reverts the image back to the specified change point.

Syntax

HRESULT RollbackToChangePoint(
  [in] LONG changePoint
);

Parameters

[in] changePoint

Change point that identifies the target state for rollback.

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_TOO_MANY_DIRS	This file system image has too many directories for the %1!ls! file system. Value: 0xC0AAB130
IMAPI_E_ISO9660_LEVELS	ISO9660 is limited to 8 levels of directories. Value: 0xC0AAB131

Remarks

Typically, an application calls the IFileSystemImage::get_ChangePoint method and stores the change point value prior to making a change to the file system. If necessary, you can pass the change point value to this method to revert changes since that point in development.

An application can call the IFileSystemImage::LockInChangePoint method to lock the state of a file system image at any point in its development. After a lock is set, you cannot call this method to revert the file system image to its earlier state.

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