ClusterClearBackupStateForSharedVolume-Funktion (resapi.h)

Löscht den Sicherungsstatus für das freigegebene Clustervolume (CSV). Der PCLUSTER_CLEAR_BACKUP_STATE_FOR_SHARED_VOLUME Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ClusterClearBackupStateForSharedVolume(
  [in] LPCWSTR lpszVolumePathName
);

Parameter

[in] lpszVolumePathName

Pfad zu einer Datei in einer CSV-Datei. Wenn der Pfad kein CSV-Pfad ist, gibt ClusterClearBackupStateForSharedVolumeERROR_INVALID_PARAMETER (87) zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS (0) zurück.

Wenn die Funktion fehlschlägt, gibt sie einen der Systemfehlercodes zurück.

Hinweise

Die ClusterClearBackupStateForSharedVolume-Funktion muss von einem Knoten des Clusters aufgerufen werden.

Normalerweise wird nach Abschluss eines Sicherungsauftrags der CSV-Status "Sicherung in Bearbeitung" (festgelegt durch ClusterPrepareSharedVolumeForBackup) automatisch gelöscht, was bedeutet, dass das CSV-Volume von diesem Clusterknoten entfernt und direkte E/A wieder aktiviert wird. Wenn der Sicherungsvorgang nach dem Aufruf von ClusterPrepareSharedVolumeForBackup und vor Abschluss des Momentaufnahme Erstellungsprozesses beendet wird, wartet CSV 30 Minuten, bevor der Status "Sicherung in Bearbeitung" gelöscht wird. Wenn der Anforderer sicher feststellen kann, dass keine anderen Sicherungen für diese CSV-Datei aktiv sind, kann ClusterClearBackupStateForSharedVolume aufgerufen werden, um den Status "Sicherung in Bearbeitung" des CSV-Volumes zu löschen.

Hinweis Wenn die ClusterClearBackupStateForSharedVolume-Funktion für ein bestimmtes CSV-Volume aufgerufen wird, wird der Sicherungsstatus für diese CSV ohne Berücksichtigung anderer Sicherungen gelöscht, die auf einem beliebigen Knoten innerhalb des Clusters aktiv sein könnten. Um eine Beschädigung einer laufenden Sicherung zu vermeiden, muss vor dem Aufruf von ClusterClearBackupStateForSharedVolume mit äußerster Sorgfalt sichergestellt werden, dass keine anderen Sicherungen für dieses CSV-Volume aktiv sind.

 

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 Enterprise, Windows Server 2008 R2 Datacenter
Zielplattform	Windows
Kopfzeile	resapi.h
Bibliothek	ResUtils.Lib
DLL	ResUtils.Dll

Weitere Informationen

Sichern und Wiederherstellen der Failoverclusterkonfiguration mithilfe von VSS

Sicherungs- und Wiederherstellungsfunktionen

CLUSCTL_RESOURCE_SET_SHARED_VOLUME_BACKUP_MODE

GetVolumePathName