Méthode IVdsLun::D elete (vdshwprv.h)
[À compter de Windows 8 et Windows Server 2012, l’interface COM du service de disque virtuel est remplacée par l’API Gestion du stockage Windows.]
Supprime le LUN et tous ses plex. Toutes les données sur la LUN sont perdues. VDS libère les étendues allouées au LUN.
Syntaxe
HRESULT Delete();
Valeur de retour
Cette méthode peut retourner des valeurs HRESULT standard, telles que E_OUTOFMEMORY, et des valeurs de retour spécifiques à VDS. Il peut également retourner des codes d’erreur système convertis à l’aide de la macro HRESULT_FROM_WIN32 . Les erreurs peuvent provenir de VDS lui-même ou du fournisseur VDS sous-jacent utilisé. Les valeurs de retour possibles sont les suivantes.
| Code/valeur de retour | Description |
|---|---|
|
Cette valeur de retour signale un problème logiciel ou de communication à l’intérieur d’un fournisseur qui met en cache des informations sur le tableau. Utilisez la méthode IVdsHwProvider::Reenumerate suivie de la méthode IVdsHwProvider::Refresh pour restaurer le cache. |
|
L’objet LUN n’est plus présent. |
|
Le LUN est dans un état d’échec et n’est pas en mesure d’effectuer l’opération demandée. |
|
Une autre opération est en cours ; cette opération ne peut pas se poursuivre tant que la ou les opérations précédentes ne sont pas terminées. |
Remarques
Si une application contient une référence à l’interface IVdsLun et appelle IVdsLun::D elete, les implémenteurs doivent retourner VDS_E_OBJECT_DELETED lors des appels suivants à des méthodes telles que GetProperties sur cette interface. Dans ce cas, l’interface a une référence en suspens et est valide, mais l’objet sous-jacent n’existe plus.
Si un LUN qui est démasqué sur un ordinateur cible est supprimé, sa visibilité sur cet ordinateur ne peut pas changer tant qu’une nouvelle analyse de bus n’est pas effectuée. L’application VDS sur l’ordinateur cible lance la nouvelle analyse du bus en appelant IVdsService::Reenumerate. Le lancement de la nouvelle analyse du bus est de la responsabilité de l’application VDS, et non du fournisseur de matériel.
Si une méthode telle que IVdsLun::D elete est appelée dans un thread tandis que IVdsSubSystem::QueryLuns est appelée dans un autre thread qui s’exécute simultanément, le résultat peut être une violation d’accès du fournisseur. Le fournisseur de matériel est responsable de la sérialisation de ces méthodes en fonction des besoins afin de réduire ces problèmes de synchronisation.
Le fournisseur de matériel est responsable de la suppression des informations de partition de la LUN afin que celle-ci puisse être réutilisée. Si le LUN est un disque MBR, cela s’effectue en écrivant des zéros sur le premier et le dernier Mo du disque. Pour un disque GPT, les zéros doivent être écrits dans le premier et le dernier 16 Ko du disque.
Configuration requise
| 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 | vdshwprv.h |
| Bibliothèque | Uuid.lib |