IVdsHwProvider ::Refresh, méthode (vds.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.]
Actualise les données mises en cache en interne de VDS sur les sous-systèmes existants gérés par les fournisseurs VDS.
Syntaxe
HRESULT Refresh();
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. |
|
Le fournisseur est dans un état d’échec et ne peut pas effectuer l’opération demandée. |
|
Une autre opération est en cours ; cette opération ne peut pas continuer tant que l’opération ou les opérations précédentes ne sont pas terminées. |
|
La méthode d’initialisation n’a pas été appelée. |
Remarques
VDS gère un cache d’informations sur les propriétés de tous les objets VDS, tels que les sous-systèmes et les contrôleurs. Chaque fois qu’une modification se produit et déclenche une notification, ce cache est mis à jour. Dans les cas où le cache n’est pas mis à jour correctement, les applications peuvent appeler cette méthode pour actualiser le cache. Notez que l’appel de cette méthode pour actualiser le cache peut à son tour déclencher des notifications supplémentaires.
Cette méthode n’interroge pas le réseau pour rechercher les sous-systèmes nouvellement connectés. Pour découvrir les sous-systèmes nouvellement connectés et déconnectés, utilisez la méthode IVdsHwProvider ::Reenumerate .
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 | vds.h |
| Bibliothèque | Uuid.lib |