IFileSystemImage::get_ChangePoint method (imapi2fs.h)

Article
10/13/2021

Retrieves the change point identifier.

Syntax

HRESULT get_ChangePoint(
  [out] LONG *pVal
);

Parameters

[out] pVal

Change point identifier. The identifier is a count of the changes to the file system image since its inception.

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
E_POINTER	Pointer is not valid. Value: 0x80004003

Remarks

An application can store the value of this property prior to making a change to the file system, then at a later point pass the value to the IFileSystemImage::RollbackToChangePoint 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. Once a lock is set, you cannot call RollbackToChangePoint 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