Partager via


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

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