Méthode IVssProviderCreateSnapshotSet ::CommitSnapshots (vsprov.h)

La méthode CommitSnapshots valide rapidement tous les LUN de ce fournisseur.

Syntaxe

HRESULT CommitSnapshots(
  [in] VSS_ID SnapshotSetId
);

Paramètres

[in] SnapshotSetId

VSS_ID qui identifie le jeu de clichés instantanés.

Valeur retournée

Code/valeur de retour	Description
S_OK 0x000000000L	L’opération s’est terminée avec succès.
E_OUTOFMEMORY 0x8007000EL	Mémoire insuffisante ou autres ressources système.
E_INVALIDARG 0x80070057L	L’une des valeurs de paramètre n’est pas valide.
VSS_E_OBJECT_NOT_FOUND 0x80042308L	Le paramètre SnapshotSetId fait référence à un objet introuvable.
VSS_E_PROVIDER_VETO 0x80042306L	Une erreur de fournisseur inattendue s’est produite. Le fournisseur doit consigner les détails de cette erreur dans le journal des événements de l’application.

 

Si une autre valeur est retournée, VSS écrit un événement dans le journal des événements et convertit l’erreur en VSS_E_UNEXPECTED_PROVIDER_ERROR.

Remarques

Cette méthode est appelée à l’heure définie à laquelle les clichés instantanés doivent être effectués. Pour chaque LUN préparé dans ce jeu de clichés instantanés, le fournisseur effectue le travail nécessaire pour conserver le contenu de la LUN à un point dans le temps. Pendant l’exécution de cette méthode, les applications et le sous-système d’E/S sont en grande partie arrêtés. Le fournisseur doit réduire le temps passé dans cette méthode. En règle générale, cette méthode doit prendre moins d’une seconde. Cette méthode est appelée pendant la fenêtre Vidage et conservation, et la prise en charge du noyau VSS annule le vidage et la conservation si la version n’est pas reçue dans les 10 secondes, ce qui entraînerait l’échec du processus de création du cliché instantané par VSS. Si chaque fournisseur prend plus d’une seconde ou deux pour effectuer cet appel, il existe une forte probabilité que la création du cliché instantané échoue.

Étant donné que le système d’E/S est en arrêt, le fournisseur doit veiller à ne pas lancer d’E/S, car il pourrait bloquer le système, par exemple déboguer ou tracer les E/S par cette méthode ou tout appel effectué à partir de cette méthode. Les fichiers mappés en mémoire et les E/S de pagination ne seront pas figés pour l’instant.

Notez que le système d’E/S n’est arrêté que pendant l’exécution de cette méthode. Immédiatement après le retour de la méthode CommitSnapshots du dernier fournisseur, le service VSS libère toutes les écritures en attente sur les LUN sources. Si le fournisseur effectue une synchronisation des LUN source et du cliché instantané, cette synchronisation doit être terminée avant que la méthode CommitSnapshots du fournisseur ne retourne ; il ne peut pas être effectué de manière asynchrone.

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

Voir aussi

IVssProviderCreateSnapshotSet