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 |
|---|---|
|
L’opération s’est terminée avec succès. |
|
Mémoire insuffisante ou autres ressources système. |
|
L’une des valeurs de paramètre n’est pas valide. |
|
Le paramètre SnapshotSetId fait référence à un objet introuvable. |
|
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 |