Méthode IVssBackupComponentsEx3 ::AddSnapshotToRecoverySet (vsbackup.h)

Article
03/03/2024

Spécifie les volumes à inclure dans une opération de resynchronisation d’unité logique. Cette méthode est prise en charge uniquement sur les systèmes d’exploitation Windows Server.

Syntaxe

HRESULT AddSnapshotToRecoverySet(
  [in]           VSS_ID   snapshotId,
  [in]           DWORD    dwFlags,
  [in, optional] VSS_PWSZ pwszDestinationVolume
);

Paramètres

[in] snapshotId

Identificateur du cliché instantané retourné par la méthode IVssBackupComponents ::AddToSnapshotSet pendant la sauvegarde. Ce paramètre est obligatoire et ne peut pas être GUID_NULL.

[in] dwFlags

Ce paramètre est réservé et doit être égal à zéro.

[in, optional] pwszDestinationVolume

Ce paramètre est facultatif et peut être NULL. La valeur NULL signifie que le contenu du volume de cliché instantané doit être copié dans le volume d’origine. VSS identifie le volume d’origine par les informations VDS_LUN_INFO dans le document Composants de sauvegarde.

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur	Signification
S_OK 0x00000000L	L'opération a réussi.
VSS_E_BAD_STATE 0x80042301L	Soit aucun fournisseur de matériel ne prend en charge l’opération, soit le demandeur n’a pas correctement ajouté de volumes au jeu de récupération.
VSS_E_LEGACY_PROVIDER 0x800423F7L	Cette version du fournisseur de matériel ne prend pas en charge cette opération.
VSS_E_OBJECT_NOT_FOUND 0x80042308L	Le paramètre snapshotId spécifie un cliché instantané qui n’est pas le propriétaire du fournisseur de matériel.
VSS_E_RESYNC_IN_PROGRESS 0x800423FFL	Une autre opération de resynchronisation de LUN est déjà en cours.
VSS_E_SNAPSHOT_NOT_IN_SET 0x8004232BL	Le paramètre snapshotId spécifie un cliché instantané qui n’existe pas dans le document composants de sauvegarde.
VSS_E_VOLUME_NOT_SUPPORTED 0x8004230CL	La resynchronisation de lun n’est pas prise en charge sur ce volume, car il s’agit d’un volume dynamique, parce que le disque de destination n’a pas d’identificateur de stockage page 83 unique, parce que le volume spécifié ne réside pas sur un numéro d’unité logique géré par un fournisseur de matériel VSS, ou parce que le disque de destination est un disque de quorum de cluster.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)

Voir aussi

IVssBackupComponentsEx3

Partager via