Méthode CVssWriter ::GetCurrentSnapshotSetId (vswriter.h)
La méthode GetCurrentSnapshotSetId retourne l’identificateur unique du jeu de cliché instantané.
GetCurrentSnapshotSetId est une méthode protégée implémentée par la classe de base CVssWriter .
Syntaxe
VSS_ID GetCurrentSnapshotSetId();
Valeur de retour
Cette méthode retourne la valeur VSS_ID du jeu de clichés instantanés actuel.
L’ID de jeu de clichés instantanés retourné par GetCurrentSnapshotSetId est l’ID de jeu de cliché instantané de l’opération de sauvegarde à laquelle participe actuellement un enregistreur.
Notez qu’un enregistreur peut être impliqué dans plusieurs opérations de sauvegarde à un moment donné. Par conséquent, si cette méthode n’est pas appelée dans le cadre d’une séquence de sauvegarde(autrement dit, n’est pas appelée à partir d’un gestionnaire d’événements), l’ID de jeu de cliché instantané qui est retourné est imprévisible.
Si GetCurrentSnapshotSetId est appelé dans le cadre d’une séquence de sauvegarde(par exemple, à partir de CVssWriter ::OnFreeze, CVssWriter ::OnThaw ou CVssWriter ::OnPostSnapshot), l’infrastructure VSS garantit que la valeur VSS_ID retournée est celle du cliché instantané prenant en charge l’opération de sauvegarde en cours.
Toutefois, cela ne peut pas être dit pour les appels à GetCurrentSnapshotSetId à partir du gestionnaire d’événements BackupShutdownCVssWriter ::OnBackupShutdown. Si un événement BackupShutdown est appelé en raison d’un arrêt brusque d’un demandeur, le VSS_ID retourné peut être celui d’une autre opération de sauvegarde à laquelle l’enregistreur a participé.
GetCurrentSnapshotSetId ne peut pas être appelé après les retours de CVssWriter ::OnPostSnapshot .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | vswriter.h (inclure Vss.h, VsWriter.h) |
| Bibliothèque | VssApi.lib |