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

  • Article

La méthode GetPreviousBackupStamp retourne un tampon de sauvegarde précédent chargé par un demandeur dans le document Composants de sauvegarde. La valeur est utilisée par un enregistreur pour décider si les fichiers doivent participer à une opération de sauvegarde différentielle ou incrémentielle.

Un writer ou un demandeur peut appeler cette méthode.

Syntaxe

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Paramètres

[out] pbstrBackupStamp

Pointeur vers une chaîne contenant l’horodatage d’une sauvegarde précédente afin qu’une sauvegarde différentielle ou incrémentielle puisse être correctement implémentée.

Valeur retournée

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

Valeur Signification
S_OK
 La valeur de l’attribut a été retournée.
S_FALSE
 Aucun horodatage de sauvegarde précédent n’a été défini.
E_INVALIDARG
 L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY
 L’appelant n’a plus de mémoire ou d’autres ressources système.
VSS_E_INVALID_XML_DOCUMENT
 Le document XML n’est pas valide. Pour plus d’informations, consultez le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Remarques

Pour plus d’informations sur les tampons de sauvegarde, consultez Rôle d’enregistreur dans Sauvegarde de magasins complexes et Rôle demandeur dans Sauvegarde de magasins complexes.

L’appelant doit libérer la mémoire détenue par le paramètre pbstrBackupStamp en appelant SysFreeString.

S’il n’existe aucun horodatage de sauvegarde précédent, GetPreviousBackupStamp retourne S_FALSE.

La chaîne retournée fait référence à tous les fichiers du composant et à tous les sous-composants non sélectionnables qu’il contient.

L’empreinte de sauvegarde récupérée par GetPreviousBackupStamp est définie par un demandeur à l’aide de IVssBackupComponents ::SetPreviousBackupStamp.

En règle générale, la chaîne utilisée pour définir la valeur trouvée par GetPreviousBackupStamp a été récupérée à partir d’un document de composants de sauvegarde stocké ou a été stockée par le demandeur dans le cadre de ses propres enregistrements internes.

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

IVssBackupComponents ::SetPreviousBackupStamp

IVssComponent