Partager via


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
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
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.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
Le fournisseur est dans un état d’échec et ne peut pas effectuer l’opération demandée.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
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.
VDS_E_INITIALIZE_NOT_CALLED
0x80042402L
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

Voir aussi

IVdsHwProvider

IVdsHwProvider ::Réumerate

IVdsHwProvider ::Refresh