Méthode IVssSoftwareSnapshotProvider ::IsVolumeSnapshotted (vsprov.h)

Article
03/03/2024

Détermine si des clichés instantanés existent pour le volume spécifié.

Syntaxe

HRESULT IsVolumeSnapshotted(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSnapshotsPresent,
  [out] LONG     *plSnapshotCompatibility
);

Paramètres

[in] pwszVolumeName

Chaîne de caractères larges terminée par null contenant le nom du volume. Le nom doit être dans l’un des formats suivants et doit inclure une barre oblique inverse de fin (\) :

Chemin d’accès d’un dossier monté, par exemple, Y :\MountX\
Une lettre de lecteur, par exemple, D :\
Chemin d’accès guid du volume au format \\ ?\Volume{GUID}\ (où GUID identifie le volume)

[out] pbSnapshotsPresent

Ce paramètre reçoit TRUE si le volume a un cliché instantané, ou FALSE si le volume n’a pas de cliché instantané.

[out] plSnapshotCompatibility

Masque de bits de VSS_SNAPSHOT_COMPATIBILITY valeurs qui indiquent si certaines opérations de contrôle de volume ou d’E/S de fichier sont désactivées pour le volume donné, si le volume a un cliché instantané.

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. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge tant que Windows Server 2008 R2 et Windows 7. E_UNEXPECTED est utilisé à la place.

Remarques

Si aucune opération de contrôle de volume ou d’E/S de fichier n’est désactivée pour le volume sélectionné, la fonctionnalité de cliché instantané du volume sélectionné retournée par plSnapshotCapability est égale à zéro.

Configuration requise

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

Voir aussi

IVssSoftwareSnapshotProvider

Partager via