Partager via

Méthode IVdsService::Refresh (vds.h)

  • Article

[À 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 informations relatives à la propriété et à la disposition du disque.

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
S_OK
 La commande s'est correctement terminée.
S_FALSE
 Une erreur s’est produite pendant cette opération.
VDS_E_INITIALIZED_FAILED
0x80042401L
 VDS n’a pas pu s’initialiser. Si une application appelle cette méthode avant la fin de l’initialisation du service, la méthode est bloquée jusqu’à la fin de l’initialisation. Si l’initialisation échoue, cette erreur est retournée.

Remarques

Cette méthode synchronise la disposition du disque avec la disposition connue du pilote de disque. Cela ne force pas le pilote à lire la disposition à partir du disque. En outre, cette méthode actualise la vue de tous les objets dans le cache VDS. VDS et les fournisseurs interrogent tous les objets, en envoyant des notifications d’arrivée, de modification et de suppression d’objets pour synchroniser l’appelant. Notez que VDS met automatiquement à jour le cache chaque fois qu’il détecte une modification qui déclenche une notification. Pour cette raison, et comme l’appel de l’actualisation peut déclencher des notifications supplémentaires, les applications ne doivent pas appeler cette méthode en réponse aux notifications. L’actualisation doit être appelée uniquement lorsqu’il apparaît que le cache n’est pas correctement mis à jour.

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 vds.h
Bibliothèque Uuid.lib

Voir aussi

IVdsService