Méthode IVssComponent ::SetBackupStamp (vswriter.h)

  • Article

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
S_OK
 Définissez correctement l’horodatage de sauvegarde.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
 L’appelant n’a pas de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE
 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

Voir aussi

IVssComponent

IVssComponent ::GetBackupStamp