Méthode IVssBackupComponents ::IsVolumeSupported (vsbackup.h)

Article
03/03/2024

La méthode IsVolumeSupported détermine si le fournisseur spécifié prend en charge les clichés instantanés sur le volume ou le partage de fichiers distant spécifié.

Syntaxe

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

Paramètres

[in] ProviderId

Identificateur du fournisseur. Si la valeur est GUID_NULL, IsVolumeSupported vérifie si un fournisseur prend en charge le volume ou le partage de fichiers distant.

[in] pwszVolumeName

Nom du volume ou chemin UNC du partage de fichiers distant. Le nom ou le chemin UNC 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)
Chemin UNC qui spécifie un partage de fichiers distant, par exemple, \\Clusterx\Share1\

[out] pbSupportedByThisProvider

Adresse d’une variable allouée à l’appelant qui reçoit TRUE si les clichés instantanés sont pris en charge sur le volume ou le partage de fichiers distant spécifié, ou FALSE dans le cas contraire.

Valeur retournée

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

Valeur	Signification
S_OK	Nous avons retourné les informations de support du fournisseur.
E_ACCESSDENIED	L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
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 pas de mémoire ou d’autres ressources système.
VSS_E_BAD_STATE	L’objet de composants de sauvegarde n’est pas initialisé, cette méthode a été appelée lors d’une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte.
VSS_E_OBJECT_NOT_FOUND	Le volume ou le partage de fichiers distant spécifié est introuvable ou n’est pas disponible.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP et Windows Server 2003 : Les partages de fichiers distants ne sont pas pris en charge tant que Windows 8 et Windows Server 2012.

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’aucun autre cliché instantané ne peut donc être créé sur ce volume), la méthode indique toujours que le volume peut être copié par ombre.

Note Pour plus d’informations sur le nombre maximal de clichés instantanés pouvant être créés sur un volume, consultez l’entrée MaxShadowCopies dans Clés de Registre et valeurs pour la sauvegarde et la restauration.

Cette méthode ne peut pas être appelée pour un disque dur virtuel (VHD) imbriqué à l’intérieur d’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

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

Voir aussi

IVssBackupComponents

IVssBackupComponents ::AddToSnapshotSet

Partager via