ClusterClearBackupStateForSharedVolume 函式 (resapi.h)
清除叢集共用磁碟區 (CSV) 的備份狀態。 PCLUSTER_CLEAR_BACKUP_STATE_FOR_SHARED_VOLUME類型會定義此函式的指標。
語法
DWORD ClusterClearBackupStateForSharedVolume(
[in] LPCWSTR lpszVolumePathName
);
參數
[in] lpszVolumePathName
CSV 上檔案的路徑。 如果路徑不是 CSV 路徑， ClusterClearBackupStateForSharedVolume 將會傳回 ERROR_INVALID_PARAMETER (87) 。
傳回值
如果函式成功，它會傳回 ERROR_SUCCESS ( 0) 。
如果函式失敗，它會傳回其中一個 系統錯誤碼。
備註
ClusterClearBackupStateForSharedVolume 函式必須從叢集的節點呼叫。
一般而言，當備份作業完成時， 會自動清除 ClusterPrepareSharedVolumeForBackup) 所設定的 CSV「進行中備份」 (狀態，這表示 CSV 磁碟區已從此叢集節點取消釘選，並重新啟用直接 I/O。 如果在呼叫 ClusterPrepareSharedVolumeForBackup 之後終止備份程式，並在快照集建立程式完成之前，CSV 會等候 30 分鐘，才會清除[進行中的備份] 狀態。 如果要求者能夠安全地判斷此 CSV 上沒有任何其他備份作用中，則可能會呼叫 ClusterClearBackupStateForSharedVolume 來清除 CSV 磁碟區的「進行中備份」狀態。
注意 當針對特定 CSV 磁碟 區呼叫 ClusterClearBackupStateForSharedVolume 函式時，會清除該 CSV 的備份狀態，而不考慮叢集內任何節點上可能作用的其他備份。 若要避免進行中的備份損毀，請務必謹慎確保此 CSV 磁碟區沒有其他作用中的備份，再呼叫 ClusterClearBackupStateForSharedVolume。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2008 R2 Enterprise、Windows Server 2008 R2 Datacenter |
| 目標平台 | Windows |
| 標頭 | resapi.h |
| 程式庫 | ResUtils.Lib |
| Dll | ResUtils.Dll |