Partager via


Fonction ClusterClearBackupStateForSharedVolume (resapi.h)

Efface l’état de sauvegarde du volume partagé de cluster (CSV). Le type PCLUSTER_CLEAR_BACKUP_STATE_FOR_SHARED_VOLUME définit un pointeur vers cette fonction.

Syntaxe

DWORD ClusterClearBackupStateForSharedVolume(
  [in] LPCWSTR lpszVolumePathName
);

Paramètres

[in] lpszVolumePathName

Chemin d’accès à un fichier sur un fichier CSV. Si le chemin n’est pas un chemin CSV, ClusterClearBackupStateForSharedVolume retourne ERROR_INVALID_PARAMETER (87).

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS (0).

Si la fonction échoue, elle retourne l’un des codes d’erreur système.

Remarques

La fonction ClusterClearBackupStateForSharedVolume doit être appelée à partir d’un nœud du cluster.

Normalement, lorsqu’une tâche de sauvegarde se termine, l’état CSV « Sauvegarde en cours » (défini par ClusterPrepareSharedVolumeForBackup) est automatiquement effacé, ce qui signifie que le volume CSV n’est pas épinglé à partir de ce nœud de cluster et que les E/S directes sont réactivées. Si le processus de sauvegarde est terminé après l’appel à ClusterPrepareSharedVolumeForBackup et avant la fin du processus de création instantané, CSV attend 30 minutes avant d’effacer l’état « Sauvegarde en cours ». Si le demandeur est en mesure de déterminer en toute sécurité qu’aucune autre sauvegarde n’est active sur ce CSV, ClusterClearBackupStateForSharedVolume peut être appelé pour effacer l’état « Sauvegarde en cours » du volume CSV.

Note Lorsque la fonction ClusterClearBackupStateForSharedVolume est appelée pour un volume CSV particulier, l’état de sauvegarde de ce CSV est effacé sans tenir compte des autres sauvegardes qui peuvent être actives sur n’importe quel nœud au sein du cluster. Pour éviter l’altération d’une sauvegarde en cours, vous devez veiller à ce qu’aucune autre sauvegarde ne soit active pour ce volume CSV avant d’appeler ClusterClearBackupStateForSharedVolume.
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 R2 Entreprise, Windows Server 2008 R2 Datacenter
Plateforme cible Windows
En-tête resapi.h
Bibliothèque ResUtils.Lib
DLL ResUtils.Dll

Voir aussi

Sauvegarde et restauration de la configuration du cluster de basculement à l’aide de VSS

Fonctions de sauvegarde et de restauration

CLUSCTL_RESOURCE_SET_SHARED_VOLUME_BACKUP_MODE

GetVolumePathName