Méthode IVssComponent ::GetPreviousBackupStamp (vswriter.h)
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 |
|---|---|
|
La valeur de l’attribut a été retournée. |
|
Aucun horodatage de sauvegarde précédent n’a été défini. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a plus de mémoire ou d’autres ressources système. |
|
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 |