IFileSystemImage::get_ChangePoint method (imapi2fs.h)

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

See also

IFileSystemImage

IFileSystemImage::LockInChangePoint

IFileSystemImage::RollbackToChangePoint