Méthode IVssBackupComponents::RevertToSnapshot (vsbackup.h)

Article
08/27/2023

La méthode RevertToSnapshot rétablit un volume à un cliché instantané précédent. Seuls les clichés instantanés créés avec des contextes persistants (VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS ou VSS_CTX_NAS_ROLLBACK) sont pris en charge.

Note Cette méthode est uniquement prise en charge sur les systèmes d’exploitation Windows Server.

Syntaxe

HRESULT RevertToSnapshot(
  [in] VSS_ID SnapshotId,
  [in] BOOL   bForceDismount
);

Paramètres

[in] SnapshotId

VSS_ID du cliché instantané à rétablir.

[in] bForceDismount

Si ce paramètre a la valeur TRUE, le volume est démonté et rétabli même si le volume est en cours d’utilisation.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	L'opération a réussi.
E_ACCESSDENIED	Le processus appelant a des privilèges insuffisants.
E_FAIL	Il y a une erreur interne.
E_INVALIDARG	L’un des paramètres passés n’est pas valide.
E_NOTIMPL	Le fournisseur du volume ne prend pas en charge les opérations de rétablissement.
E_OUTOFMEMORY	L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_OBJECT_NOT_FOUND	Le paramètre SnapshotId n’est pas un cliché instantané valide.
VSS_E_PROVIDER_NOT_REGISTERED	Le fournisseur est introuvable.
VSS_E_REVERT_IN_PROGRESS	Le volume a déjà un rétablissement en cours.
VSS_E_UNSUPPORTED_CONTEXT	La restauration est uniquement prise en charge pour les clichés instantanés persistants.
VSS_E_VOLUME_IN_USE	Le paramètre bForceDismount était FALSE et le volume n’a pas pu être verrouillé.
VSS_E_VOLUME_NOT_SUPPORTED	La restauration n’est pas prise en charge sur ce volume.

Remarques

Cette opération ne peut pas être annulée ou annulée une fois terminée. Si l’ordinateur est redémarré pendant l’opération de restauration, le processus de restauration se poursuit lorsque le système est redémarré.

Configuration requise


Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008, Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib

Voir aussi

IVssBackupComponents

IVssBackupComponents::QueryRevertStatus

Partager via