Méthode IVdsVolumeMF3 ::OfflineVolume (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.]

Met le volume hors connexion à l’aide du code de contrôle IOCTL_VOLUME_OFFLINE .

Syntaxe

HRESULT OfflineVolume();

Valeur de retour

Cette méthode peut retourner des valeurs HRESULT standard, telles que E_INVALIDARG ou 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 de retour Description
S_OK
 La commande s'est correctement terminée.

Notes

Si le volume est déjà hors connexion, la méthode OfflineVolume retourne S_OK.

Lorsqu’un volume est hors connexion, toutes les demandes de lecture, d’écriture et IOCTL échouent avec ERROR_NOT_READY. Vous ne pouvez pas mettre le système ou le volume de démarrage hors connexion.

Lorsqu’un volume est en ligne, toutes les demandes envoyées au volume sont honorées.

Lorsqu’un volume en ligne est démonté, l’appel suivant pour ouvrir le volume entraîne son montage. La mise hors connexion du volume empêche le montage du volume démonté. Pour démonter un volume, utilisez la méthode IVdsVolumeMF ::D ismount .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête vds.h
Bibliothèque Uuid.lib

Voir aussi

IVdsVolumeMF3