Méthode IVssBackupComponents ::AddToSnapshotSet (vsbackup.h)
La méthode AddToSnapshotSet ajoute un volume d’origine ou un partage de fichiers distant d’origine au jeu de clichés instantanés.
Syntaxe
HRESULT AddToSnapshotSet(
[in] VSS_PWSZ pwszVolumeName,
[in] VSS_ID ProviderId,
[out] VSS_ID *pidSnapshot
);
Paramètres
[in] pwszVolumeName
Chaîne de caractères larges terminée par null contenant le nom du volume ou le chemin UNC du partage de fichiers distant à copier en ombre. 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\
- Une lettre de lecteur, par exemple, D :\
- Chemin d’accès guid du volume au format \\ ?\Volume{GUID}\ (où GUID identifie le volume)
- Chemin d’accès UNC qui spécifie un partage de fichiers distant, par exemple, \\Clusterx\Share1\
[in] ProviderId
Fournisseur à utiliser. GUID_NULL peut être utilisé, auquel cas le fournisseur par défaut est utilisé.
[out] pidSnapshot
Identificateur retourné du cliché instantané ajouté.
Valeur retournée
Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
Ajout du volume ou du partage de fichiers distant au jeu de clichés instantanés. |
|
L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
L’appelant n’a plus 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 pendant une opération de restauration ou cette méthode n’a pas été appelée dans la séquence correcte. |
|
Le nombre maximal de volumes ou de partages de fichiers distants ont été ajoutés au jeu de clichés instantanés. Le volume ou le partage de fichiers distant spécifié n’a pas été ajouté au jeu de clichés instantanés. |
|
Le volume ou le partage de fichiers distant a été ajouté au nombre maximal de jeux de clichés instantanés. Le volume ou le partage de fichiers distant spécifié n’a pas été ajouté au jeu de clichés instantanés. |
|
Le volume spécifié est imbriqué trop profondément pour participer à l’opération VSS. Les raisons possibles de cette erreur sont les suivantes :
|
|
pwszVolumeName ne correspond pas à un volume existant ou à un partage de fichiers distant. |
|
ProviderId ne correspond pas à un fournisseur inscrit. |
|
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. |
|
Une autre création de cliché instantané est déjà en cours. Se produit lors de l’ajout d’un volume CSV à un instantané défini à partir de plusieurs nœuds en même temps, ou lors de l’ajout d’un partage de scale-out au jeu de instantané à partir de plusieurs nœuds clients SMB en même temps. |
|
La valeur du paramètre ProviderId est GUID_NULL et aucun fournisseur VSS n’indique qu’il prend en charge le volume ou le partage de fichiers distant spécifié. |
|
Le volume ou le partage de fichiers distant n’est pas pris en charge par le fournisseur spécifié. |
|
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. |
|
Le fournisseur a retourné un code d’erreur inattendu. Ce code d’erreur est retourné uniquement via la méthode QueryStatus sur l’interface IVssAsync retournée dans le paramètre ppAsync . |
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 qu’Windows 8 et Windows Server 2012.
Si pwszVolumeName est un chemin de partage UNC, la partie nom du serveur doit être au format de nom d’hôte ou de nom de domaine complet. Les noms de partage UNC avec des adresses IP doivent être normalisés en appelant la méthode IVssBackupComponentsEx4 ::GetRootAndLogicalPrefixPaths avant qu’ils ne soient transmis à AddToSnapshotSet.
Le nombre maximal de volumes copiés dans un seul jeu de clichés instantanés s’élève à 64.
Si ProviderId est GUID_NULL, le fournisseur par défaut est sélectionné selon l’algorithme suivant :
- Si un fournisseur de matériel prend en charge le volume donné ou le partage de fichiers distant, ce fournisseur est sélectionné.
- Si aucun fournisseur de matériel n’est disponible, si un fournisseur de logiciels prend en charge le volume donné, il est sélectionné.
- Si aucun fournisseur de matériel ou de logiciel n’est disponible, le fournisseur système est sélectionné. (Il n’existe qu’un seul fournisseur système préinstallé, qui doit prendre en charge tous les volumes locaux non amovibles.)
Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Les disques durs virtuels ne sont pas pris en charge.
L’identificateur de cliché instantané retourné dans le paramètre pidSnapshot est stocké dans le document Composants de sauvegarde. Toutefois, il n’existe aucune méthode pour interroger ces informations, et l’appelant peut avoir besoin de les stocker afin qu’elles puissent être utilisées lors de la restauration.
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 |