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
S_OK	Les clichés instantanés ont été correctement exposés.
E_ACCESSDENIED	L’appelant ne dispose pas de privilèges de sauvegarde suffisants ou n’est pas administrateur.
E_INVALIDARG	L’une des valeurs de paramètre n’est pas valide.
E_OUTOFMEMORY	L’appelant n’a plus 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 pendant 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 cliché instantané spécifié n’existe pas.
VSS_E_PROVIDER_VETO	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.
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.
VSS_E_UNEXPECTED_PROVIDER_ERROR	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

IVssBackupComponents ::ImportSnapshots

IVssBackupComponentsEx2 ::UnexposeSnapshot

VSS_PWSZ

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES