Partager via

Méthode IVssSoftwareSnapshotProvider ::BeginPrepareSnapshot (vsprov.h)

  • Article

VSS appelle cette méthode pour chaque cliché instantané ajouté au jeu de clichés instantanés.

Syntaxe

HRESULT BeginPrepareSnapshot(
  [in] VSS_ID   SnapshotSetId,
  [in] VSS_ID   SnapshotId,
  [in] VSS_PWSZ pwszVolumeName,
  [in] LONG     lNewContext
);

Paramètres

[in] SnapshotSetId

Identificateur du jeu de clichés instantanés.

[in] SnapshotId

Identificateur du cliché instantané à créer.

[in] pwszVolumeName

Chaîne de caractères larges terminée par null contenant le nom du volume. Le nom 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)

[in] lNewContext

Contexte du jeu de clichés instantanés. Ce contexte se compose d’un masque de bits de valeurs _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

Valeur retournée

Voici les codes de retour valides pour cette méthode.

Valeur Signification
S_OK
 Le cliché instantané a été créé avec succè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_OBJECT_NOT_FOUND
 Le volume spécifié est introuvable.
VSS_E_PROVIDER_VETO
 Erreur du fournisseur. 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_UNSUPPORTED_CONTEXT
 Le contexte spécifié n’est pas pris en charge.
VSS_E_VOLUME_NOT_SUPPORTED_BY_PROVIDER
 Le fournisseur ne prend pas en charge le volume spécifié.
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.

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 vsprov.h
Bibliothèque VssApi.lib

Voir aussi

IVssSoftwareSnapshotProvider