清除群集共享卷的备份状态 (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 的备份状态，而不考虑群集内任何节点上可能处于活动状态的其他备份。 为了避免正在进行的备份损坏，在调用 ClusterClearBackupStateForSharedVolume 之前，必须格外小心，确保此 CSV 卷没有其他活动备份。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2008 R2 Enterprise、Windows Server 2008 R2 Datacenter |
| 目标平台 | Windows |
| 标头 | resapi.h |
| Library | ResUtils.Lib |
| DLL | ResUtils.Dll |