StartImageUpdate
Command:
StartImageUpdate (DcsSnap#)
Description:
This command is used to start the Image Update process on a particular snapshot relationship. Perform the Image Update process on a snapshot relationship if you want to update the destination volume image with the latest changes to the source volume.
Arguments:
DcsSnap# : A value that represents the snapshot relationship number.
Return Value:
0: success.
-1: failure. Call GetLastErrors for extended error code information.
Error Codes:
DCSPIT_ERROR_CANCELLED: The process was terminated by using the StopImageUpdate command.
DCSPIT_ERROR_INVALID_PARAMETER: There is either a potential version mismatch between API and driver, or the snapshot is not enabled.
DCSPIT_ERROR_DEVICE_DOES_NOT_EXIST: The snapshot relationship does not exist.
ERROR_INVALID_PARAMETER: hDeviceHandle is an invalid handle.
Comments:
If you want to monitor the progress of the process, you can use GetSnapStatus or GetSnapExtendedStatus to verify that the process is still active.
The destination volume of the snapshot relationship must not accessed while this process is taking place.
If you had a Complete Image, a complete physical copy of source volume data on the destination volume, prior to performing the Image Update process on a snapshot relationship, and you want to re-establish the complete image, you must perform the StartCompleteImage command again, once the Image Update process has completed.