Fonction IsVolumeSnapshotted (vsbackup.h)

Article
03/13/2024

La fonction IsVolumeSnapshotted détermine si des clichés instantanés existent pour le volume spécifié.

Note Cette fonction est exportée en tant que IsVolumeSnapshottedInternal, mais vous devez appeler IsVolumeSnapshotted, et non IsVolumeSnapshottedInternal.

Syntaxe

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

Paramètres

[in] pwszVolumeName

Nom du volume. Le nom du volume à vérifier 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\
Lettre de lecteur, par exemple, D :\
Chemin d’accès GUID de volume de la forme \\ ?\Volume{GUID}\ (où GUID identifie le volume)

[out] pbSnapshotsPresent

La valeur de ce paramètre est TRUE si le volume a un cliché instantané et FALSE si le volume n’a pas de cliché instantané.

[out] plSnapshotCapability

Un masque de bits (ou OR au niveau du bit) de VSS_SNAPSHOT_COMPATIBILITY valeurs qui indique si certaines opérations de contrôle de volume ou d’E/S de fichier sont désactivées pour le volume donné s’il existe un cliché instantané de celui-ci.

Valeur retournée

Les valeurs de retour répertoriées ici s’ajoutent aux valeurs COM HRESULTnormales qui peuvent être retournées à tout moment à partir de la fonction.

Valeur	Signification
S_OK	La fonction s’est terminée avec succès.
E_ACCESSDENIED	L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	Mémoire insuffisante ou autres ressources système.
VSS_E_PROVIDER_VETO	Erreur du fournisseur attendue. 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_OBJECT_NOT_FOUND	Le volume spécifié est introuvable.
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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Erreur de fournisseur inattendue. Le code d’erreur est consigné dans le fichier journal des événements. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS.

Remarques

Avant d’appeler cette fonction, l’appelant doit avoir initialisé COM en appelant la fonction CoInitialize .

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é par plSnapshotCapability est nulle.

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	vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h)
Bibliothèque	VssApi.lib
DLL	VssApi.dll

Voir aussi

VSS_SNAPSHOT_COMPATIBILITY

Partager via