Partager via


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
S_OK
La valeur de l’attribut a été retournée.
S_FALSE
Aucun horodatage n’est associé à ce composant.
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_INVALID_XML_DOCUMENT
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

Voir aussi

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent

IVssComponent::SetBackupStamp