Partager via

Méthode IVssFileShareSnapshotProvider ::GetSnapshotProperties (vsprov.h)

  • Article

Obtient la structure VSS_SNAPSHOT_PROP d’un partage de fichiers instantané.

Syntaxe

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

Paramètres

[in] SnapshotId

Identificateur de cliché instantané.

[out] pProp

Adresse d’une structure de VSS_SNAPSHOT_PROP allouée à l’appelant qui reçoit les propriétés de cliché instantané. Le fournisseur est chargé de définir les membres de cette structure. Tous les membres sont obligatoires, sauf m_pwszExposedName et m_pwszExposedPath, que le fournisseur peut définir sur NULL. Le fournisseur alloue de la mémoire pour tous les membres de chaîne qu’il définit dans la structure. Lorsque la structure n’est plus nécessaire, l’appelant est chargé de libérer ces chaînes en appelant la fonction VssFreeSnapshotProperties .

Valeur retournée

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

Valeur Signification
S_OK
 Les informations demandées ont été retournées avec succès.
E_ACCESSDENIED
 L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
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_OBJECT_NOT_FOUND
 Le volume spécifié est introuvable.
VSS_E_PROVIDER_VETO
 Erreur du fournisseur. Le fournisseur a enregistré l’erreur dans le journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.
VSS_E_UNEXPECTED
 Erreur inattendue. Le code d’erreur est enregistré dans le fichier journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Remarques

L’appelant doit définir le contenu de la structure VSS_SNAPSHOT_PROP sur zéro avant d’appeler la méthode GetSnapshotProperties .

Le fournisseur est responsable de l’allocation et de la libération des chaînes dans la structure VSS_SNAPSHOT_PROP .

Le coordinateur VSS appelle cette méthode pendant la phase PostSnapshot de instantané création afin de récupérer le chemin d’accès instantané (chemin UNC pour les instantanés de partage de fichiers). Le coordinateur appelle cette méthode après PreFinalCommitSnapshots et avant d’appeler PostSnapshot dans les writers.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vsprov.h
Bibliothèque VssApi.lib

Voir aussi

IVssFileShareSnapshotProvider