Méthode IVssHardwareSnapshotProvider ::OnLunEmpty (vsprov.h)

  • Article

La méthode OnLunEmpty est appelée chaque fois que VSS détermine qu’un cliché instantané ne contient aucune donnée intéressante. Tous les clichés instantanés ont été supprimés (ce qui entraîne également la suppression de la LUN.) Les ressources LUN peuvent être récupérées par le fournisseur et réutilisées à d’autres fins. VSS démontera tous les volumes affectés. Un fournisseur ne doit pas émettre de réanalyse pendant OnLunEmpty. VSS gère ce nettoyage.

Note Les fournisseurs de matériel sont uniquement pris en charge sur les systèmes d’exploitation Windows Server.
 

Syntaxe

HRESULT OnLunEmpty(
  [in] VSS_PWSZ            wszDeviceName,
  [in] VDS_LUN_INFORMATION *pInformation
);

Paramètres

[in] wszDeviceName

Appareil correspondant à la LUN qui contient le cliché instantané à supprimer.

[in] pInformation

Pointeur vers une structure VDS_LUN_INFORMATION contenant des informations sur la LUN contenant le cliché instantané à supprimer.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

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_PROVIDER_VETO
0x80042306L
 Une erreur de fournisseur inattendue s’est produite. Le fournisseur doit signaler un événement dans le journal des événements de l’application, fournissant à l’utilisateur des informations sur la façon de résoudre le problème.

Remarques

Les fournisseurs de matériel doivent supprimer un cliché instantané et récupérer la LUN si et uniquement si
OnLunEmpty est appelé. Un cliché instantané matériel peut être utilisé comme support de sauvegarde lui-même. Par conséquent, les LUN doivent être traitées avec le même soin que le tableau de stockage traite les LUN utilisés pour les disques standard. La récupération de LUN en dehors du traitement pour OnLunEmpty doit être limitée à une urgence ou à un administrateur effectuant une action explicite manuellement.

Dans le cas de clichés instantanés persistants, le demandeur supprime le cliché instantané lorsqu’il n’est plus nécessaire. Dans le cas de clichés instantanés à libération automatique non persistante, le service VSS supprime le cliché instantané lorsque le demandeur appelle IUnknown ::Release sur l’objet IVssBackupComponents . Dans le cas de clichés instantanés non persistants non à libération automatique, le service VSS supprime le cliché instantané lors du redémarrage de l’ordinateur. Dans tous les cas, le service VSS appelle la méthode OnLunEmpty du fournisseur en fonction des besoins pour chaque lun de cliché instantané.

Notez qu’OnLunEmpty est appelé sur la base du meilleur effort. VSS appelle la méthode uniquement lorsque la LUN est garantie d’être vide. Il peut y avoir de nombreux cas où la LUN est vide, mais VSS ne peut pas le détecter en raison d’erreurs ou de circonstances externes. Dans ce cas, l’utilisateur doit utiliser le logiciel de gestion du stockage pour effacer cet état.

Exemples :

  • Lorsqu’une lun de cliché instantané est déplacée vers un autre hôte, mais qu’elle n’est pas réellement transportée ou importée via VSS, cette LUN apparaît comme n’importe quelle autre LUN, et les volumes peuvent simplement être supprimés sans notification de VSS.
  • Un incident ou un redémarrage inattendu au milieu d’une création de cliché instantané.
  • Importation annulée.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vsprov.h

Voir aussi

IVssHardwareSnapshotProvider