Méthode IVssBackupComponents ::ExposeSnapshot (vsbackup.h)
La méthode ExposeSnapshot expose un cliché instantané sous la forme d’une lettre de lecteur, d’un dossier monté ou d’un partage de fichiers.
Syntaxe
HRESULT ExposeSnapshot(
[in] VSS_ID SnapshotId,
[in] VSS_PWSZ wszPathFromRoot,
[in] LONG lAttributes,
[in] VSS_PWSZ wszExpose,
[out] VSS_PWSZ *pwszExposed
);
Paramètres
[in] SnapshotId
Identificateur de cliché instantané.
[in] wszPathFromRoot
Chemin d’accès à la partie du volume rendue disponible lors de l’exposition d’un cliché instantané en tant que partage de fichiers. La valeur de ce paramètre doit être NULL lors de l’exposition d’un cliché instantané localement ; autrement dit, l’exposer sous la forme d’une lettre de lecteur ou d’un dossier monté.
Le chemin d’accès ne peut pas contenir de variables d’environnement (par exemple, %MyEnv%) ou de caractères génériques.
Il n’est pas nécessaire que le chemin se termine par une barre oblique inverse (« »). Il appartient aux applications qui récupèrent ces informations de case activée.
[in] lAttributes
Attributs du cliché instantané exposé indiquant s’il est exposé localement ou à distance. La valeur doit être la valeur VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY ou la valeur VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY de _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.
[in] wszExpose
Lorsqu’un cliché instantané est exposé en tant que partage de fichiers, la valeur de ce paramètre est le nom du partage. Si un cliché instantané est exposé en le montant en tant qu’appareil, la valeur du paramètre est une lettre de lecteur suivie d’un signe deux-points, par exemple, « X : » ou un chemin d’accès au dossier monté (par exemple, « Y :\MountX »). Si la valeur de ce paramètre est NULL, VSS détermine le nom de partage ou la lettre de lecteur si le paramètre lAttributes est VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY.
[out] pwszExposed
Nom exposé du cliché instantané. Il s’agit d’un nom de partage, d’une lettre de lecteur suivie d’un deux-points ou d’un dossier monté. La valeur est NULL si ExposeSnapshot a échoué. VSS alloue la mémoire pour cette chaîne.
Valeur retournée
Voici les codes de retour valides pour cette méthode.
| Valeur | Signification |
|---|---|
|
Les clichés instantanés ont été correctement exposé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 cliché instantané spécifié n’existe pas. |
|
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. |
|
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. |
|
Erreur de fournisseur inattendue. Le code d’erreur est journalisé dans le journal des erreurs. Pour plus d’informations, consultez Gestion des événements et des erreurs sous VSS. |
Remarques
L’appelant est chargé de libérer la chaîne vers laquelle pointe le paramètre pwszExposed en appelant la fonction CoTaskMemFree .
Lors de l’exposition d’un cliché instantané persistant, il reste exposé lors des démarrages suivants.
Lors de l’exposition d’un cliché instantané d’un volume, le cliché instantané peut être traité comme un appareil montable ou comme un système de fichiers disponible pour le partage de fichiers.
Lorsqu’il est exposé en tant qu’appareil, comme avec d’autres appareils montables, le cliché instantané d’un volume est exposé à son point de montage (lettre de lecteur ou dossier monté) à partir de sa racine.
Lorsqu’ils sont exposés en tant que partage de fichiers, les sous-ensembles ( indiqués par wszPathFromRoot) du volume peuvent être partagés.
Pour plus d’informations sur l’exposition des clichés instantanés, consultez Exposition et exposition de volumes copiés en ombre.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 | vsbackup.h (inclure VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothèque | VssApi.lib |
Voir aussi
IVssBackupComponents ::ImportSnapshots