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 |
|---|---|
|
Nous avons retourné les informations de support du fournisseur. |
|
L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur. |
|
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. |
|
L’appelant n’a pas de mémoire ou d’autres ressources système. |
|
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. |
|
Le volume ou le partage de fichiers distant spécifié est introuvable ou n’est pas disponible. |
|
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.
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour