Méthode IVssComponent ::SetBackupStamp (vswriter.h)
La méthode SetBackupStamp définit une chaîne contenant des informations indiquant quand une sauvegarde a eu lieu.
Un enregistreur peut appeler cette méthode uniquement pendant une opération de sauvegarde.
Cette méthode ne peut pas être appelée lors de la gestion d’un événement BackupComplete (CVssWriter ::OnBackupComplete) ou BackupShutdown (CVssWriter ::OnBackupShutdown).
Syntaxe
HRESULT SetBackupStamp(
[in] LPCWSTR wszBackupStamp
);
Paramètres
[in] wszBackupStamp
Informations sur les chaînes de caractères larges terminées par null indiquant quand une sauvegarde a eu lieu.
Valeur retournée
Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
Définissez correctement l’horodatage de sauvegarde. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a pas de mémoire ou d’autres ressources système. |
|
Cette méthode n’a pas été appelée par un enregistreur ou, si elle est appelée par un enregistreur, elle n’a pas été appelée lors d’une opération de sauvegarde ou a été appelée lors de la gestion d’un événement BackupComplete ou BackupShutdown. |
Remarques
Pour plus d’informations sur les tampons de sauvegarde, consultez Rôle d’enregistreur dans la sauvegarde de magasins complexes.
Le tampon de sauvegarde défini par SetBackupStamp s’applique à tous les fichiers du composant et à tous les sous-composants non sélectionnables dont il dispose.
Les rédacteurs appellent généralement SetBackupStamp lors de la gestion d’un événement PostSnapshot dans CVssWriter ::OnPostSnapshot.
Les demandeurs stockent simplement l’empreinte de sauvegarde dans le document Composants de sauvegarde. Ils n’utilisent pas directement l’empreinte de sauvegarde ou doivent savoir comment l’interpréter.
La seule utilisation de l’empreinte de sauvegarde effectuée par un demandeur, lors d’une opération de restauration, consiste à rendre la chaîne d’horodatage stockée disponible pour un enregistreur à l’aide de la méthode IVssBackupComponents ::SetPreviousBackupStamp .
Pour cette raison, il n’existe aucune restriction de format sur le contenu de l’empreinte de sauvegarde. Il peut contenir des informations d’heure et de date, des numéros de séquence logique ou toute autre information qui permettra à un enregistreur de la même classe de déterminer quand la dernière sauvegarde a eu lieu.
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 |