This topic has not yet been rated - Rate this topic

ClusterClearBackupStateForSharedVolume function

Applies to: desktop apps only

Clears the backup state for the cluster shared volume (CSV).

Syntax

Copy

DWORD WINAPI ClusterClearBackupStateForSharedVolume(
  __in  LPCWSTR lpszVolumePathName
);

Parameters

lpszVolumePathName [in]: Path to a file on a CSV. If the path is not a CSV path, ClusterClearBackupStateForSharedVolume will return ERROR_INVALID_PARAMETER (87).

Return value

If the function succeeds, it returns ERROR_SUCCESS (0).

If the function fails, it returns one of the system error codes.

Remarks

The ClusterClearBackupStateForSharedVolume function must be called from a node of the cluster.

Normally, when a backup job completes, the CSV "Backup in Progress" state (set by ClusterPrepareSharedVolumeForBackup) is automatically cleared—meaning that the CSV volume is unpinned from this Cluster node and direct I/O is re-enabled. If the backup process is terminated after the call to ClusterPrepareSharedVolumeForBackup and before the snapshot creation process is complete, CSV will wait 30 minutes before it will clear the "Backup in Progress" state. If the requester is able to safely determine that no other backups are active on this CSV, ClusterClearBackupStateForSharedVolume may be called to clear the "Backup in Progress" state of the CSV volume.

Note When the ClusterClearBackupStateForSharedVolume function is called for a particular CSV volume, the Backup State for that CSV is cleared without regard to other backups that could be active on any node within the Cluster. To avoid corruption of an in-progress backup, extreme care must be taken to ensure that there are no other backups active for this CSV volume before calling ClusterClearBackupStateForSharedVolume.

Requirements