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

Article
08/27/2023

Détermine si le fournisseur prend en charge les clichés instantanés sur le volume spécifié.

Syntaxe

HRESULT IsVolumeSupported(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

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] pbSupportedByThisProvider

Ce paramètre reçoit TRUE si les clichés instantanés sont pris en charge sur le volume spécifié, sinon FALSE.

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.
VSS_E_NESTED_VOLUME_LIMIT	Le volume spécifié est imbriqué trop profondément pour participer à l’opération VSS. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Ce code de retour n’est pas pris en charge.
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

La méthode IsVolumeSupported retourne TRUE s’il est possible de créer des clichés instantanés sur le volume donné, même si la configuration actuelle n’autorise pas la création de clichés instantanés sur ce volume à l’heure actuelle.

Par exemple, si le nombre maximal de clichés instantanés a été atteint sur un volume donné (et qu’il n’est donc plus possible de créer des clichés instantanés sur ce volume), la méthode indique toujours que le volume peut être copié en mode instantané.

Cette méthode ne peut pas être appelée pour un disque dur virtuel imbriqué dans un autre disque dur virtuel.

Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Les disques durs virtuels ne sont pas pris en charge.

Configuration requise


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