Gestion des erreurs dans les fournisseurs de clichés instantanés

VSS permet l’existence de nombreux clichés instantanés à la fois, mais il n’autorise qu’une seule création de jeu de clichés instantanés en cours entre l’appel à IVssBackupComponents :: StartSnapshotSet et le retour de l’appel à IVssBackupComponents ::D osnapshotset.

Aucune validation partielle

Si un fournisseur échoue sur un volume ou un numéro d’unité logique du jeu de clichés instantanés, la création du jeu de clichés instantanés entier échoue. C'est la procédure normale. Cette conception simplifie les problèmes de comportement associés à la sémantique de défaillance partielle et conserve un point dans le temps cohérent pour tous les clichés instantanés de l’ensemble.

Signalement des conditions d’erreur

Si une erreur de fournisseur ou une condition d’erreur se produit, le fournisseur doit consigner une erreur dans le journal des événements de l’application. Cela comprend, sans s’y limiter, les erreurs spécifiques au fournisseur lors de la création ou de l’importation d’un jeu de clichés instantanés, ou l’échec d’allocation de ressources pour le cliché instantané de copie sur écriture après la création. Cette journalisation ne doit pas avoir lieu au moment où les volumes dans le jeu de clichés instantanés sont dans un état figé.

Valeurs de retour de fournisseur valides

Le tableau suivant répertorie les codes de retour valides pour les méthodes de fournisseur et leurs significations.

Valeur Description
_OK
La méthode a réussi.
_OUTOFMEMORY E
Le fournisseur ne dispose pas de suffisamment de mémoire ou d’autres ressources système.
E _ INVALIDARG
L’une des valeurs de paramètre n’est pas valide.
_ACCESSDENIED E
Un client non privilégié a tenté d’appeler le fournisseur.
_ _ état incorrect de VSS E _
Aucun fournisseur ne prend en charge l’opération demandée ou l’opération ne peut pas être effectuée sur l’objet, car l’objet n’est pas dans l’état correct.
_objet VSS _ E _ _ introuvable
Un paramètre fait référence à un objet qui est introuvable (par exemple, un ID de cliché instantané, un ID de jeu de clichés instantanés ou un volume).
VSS _ E _ stockage insuffisant _
Le fournisseur ne peut pas effectuer l’opération, car l’espace disque est insuffisant.
_volume E _ VSS _ non _ pris en charge
Aucun fournisseur sur cet ordinateur ne prend en charge l’opération demandée sur le volume.
_volume E _ VSS _ non _ pris en charge _ par le _ fournisseur
Le fournisseur ne prend pas en charge le volume.
_ _ _ nombre maximal _ de _ captures instantanées de _ VSS E atteint
Le fournisseur a atteint le nombre maximal de clichés instantanés qu’il peut prendre en charge.
_veto du _ fournisseur VSS E _
Le fournisseur a rencontré une erreur d’exécution interne qui n’est pas mappée à une autre valeur de retour. Le fournisseur doit également écrire un événement dans le journal des événements de l’application pour fournir à l’utilisateur des informations sur la façon de résoudre ce problème.
VSS _ E _ ne peut pas _ rétablir le _ dépatinage
La signature MBR ou l’ID GPT d’un ou plusieurs disques n’a pas pu être défini sur la valeur demandée. Pour plus d’informations, consultez le journal des événements d’application.

Le fournisseur ne doit pas tenter de retourner d’autres codes d’erreur.

Si le fournisseur retourne un code d’erreur qui n’est pas attendu (par exemple, a la _ valeur false, e _ Fail, e _ inattendue ou e _ Abort), VSS écrit un événement dans le journal des événements en mentionnant le fournisseur et la méthode qui a échoué, et convertit l’erreur en _ erreur VSS E _ inattendue du _ fournisseur _ avant de retourner au demandeur. Cela n’est pas effectué pour les retours de IVssProviderCreateSnapshotSet :: AbortSnapshots ou IVssProviderNotifications :: OnUnload.