Méthode IVssComponent::GetBackupStamp (vswriter.h)
La méthode GetBackupStamp retourne la chaîne d’empreinte de sauvegarde stockée par un enregistreur pour un composant donné.
Un enregistreur ou un demandeur peut appeler cette méthode.
Syntaxe
HRESULT GetBackupStamp(
[out] BSTR *pbstrBackupStamp
);
Paramètres
[out] pbstrBackupStamp
Adresse d’une variable allouée à l’appelant qui reçoit une chaîne contenant l’empreinte de sauvegarde indiquant l’heure à laquelle le composant a été sauvegardé.
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 n’est associé à ce composant. |
|
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. |
|
Le document XML n’est pas valide. Consultez le journal des événements pour plus d’informations. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS. |
Remarques
Si aucun horodatage de sauvegarde n’a été défini, GetBackupStamp retourne S_FALSE.
Si l’appel à GetBackupStamp réussit, l’appelant est chargé de libérer la chaîne retournée dans le paramètre pbstrBackupStamp en appelant la fonction SysFreeString .
La chaîne retournée fait référence à tous les fichiers du composant et à tous les sous-composants non sélectionnables qu’il possède.
Le tampon de sauvegarde récupéré par GetBackupStamp est généralement défini par un enregistreur par un appel à IVssComponent::SetBackupStamp à partir du gestionnaire d’événements PostSnapshot , CVssWriter::OnPostSnapshot.
Les demandeurs stockent simplement les empreintes de sauvegarde dans le document Composants de sauvegarde ; ils n’utilisent pas directement l’empreinte de sauvegarde, ne savent pas comment le générer ou en comprennent le format.
Configuration requise
| 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 |