Méthode IVdsService::Refresh (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 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 |
|---|---|
|
La commande s'est correctement terminée. |
|
Une erreur s’est produite pendant cette opération. |
|
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 |