Partager via


énumération VDS_DRIVE_STATUS (vdshwprv.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.]

Définit l’ensemble de valeurs de status d’objet pour un lecteur.

Syntax

typedef enum _VDS_DRIVE_STATUS {
  VDS_DRS_UNKNOWN = 0,
  VDS_DRS_ONLINE = 1,
  VDS_DRS_NOT_READY = 2,
  VDS_DRS_OFFLINE = 4,
  VDS_DRS_FAILED = 5,
  VDS_DRS_REMOVED = 8
} VDS_DRIVE_STATUS, *PVDS_DRIVE_STATUS;

Constantes

 
VDS_DRS_UNKNOWN
Valeur : 0
Impossible de déterminer la status du lecteur.
VDS_DRS_ONLINE
Valeur : 1
Le lecteur est disponible et en cours d’utilisation. La valeur VDS_HEALTH associée à ce lecteur status peut être n’importe quelle valeur à l’exception de VDS_H_FAILED.
VDS_DRS_NOT_READY
Valeur : 2
Le lecteur est occupé. La valeur VDS_HEALTH peut être n’importe quelle valeur à l’exception de VDS_H_FAILED.
VDS_DRS_OFFLINE
Valeur : 4
Le lecteur est physiquement présent, mais a été supprimé de son groupe RAID ou de son pool de stockage. Par exemple, si le lecteur a été supprimé de son groupe RAID en raison d’un échec, le lecteur status doit être VDS_DRS_FAILED. Si le lecteur a été supprimé dans le cadre du rééquilibrage du stockage, le lecteur status doit être VDS_DRS_OFFLINE.

Lorsque cette status de lecteur est définie, une notification VDS_NF_DRIVE_REMOVED est envoyée.

La valeur VDS_HEALTH peut être n’importe quelle valeur.
VDS_DRS_FAILED
Valeur : 5
Le lecteur a échoué. La valeur VDS_HEALTH doit être VDS_H_FAILED ou VDS_H_FAILING.
VDS_DRS_REMOVED
Valeur : 8
Le lecteur a été physiquement débranché du sous-système. Lorsque cette status est définie, une notification VDS_NF_DRIVE_DEPART est envoyée.

Windows Server 2008, Windows Vista et Windows Server 2003 : Cette valeur n’est pas prise en charge.

Remarques

La méthode IVdsDrive ::SetStatus transmet une valeur VDS_DRIVE_STATUS en tant qu’argument pour définir la status d’un lecteur, et la structure VDS_DRIVE_PROP inclut une valeur VDS_DRIVE_STATUS en tant que membre pour indiquer la status actuelle.

Si votre application rencontre une valeur VDS_DRIVE_STATUS qu’elle ne reconnaît pas, elle doit afficher le lecteur status comme étant inconnu. Il ne doit pas tenter de mapper le lecteur non reconnu status à un autre lecteur status.

Note Des constantes supplémentaires peuvent être ajoutées à l’énumération VDS_DRIVE_STATUS dans les futures versions de Windows. Pour cette raison, votre application doit être conçue pour gérer correctement une constante d’énumération VDS_DRIVE_STATUS non reconnue.
 

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]
En-tête vdshwprv.h

Voir aussi

IVdsDrive ::SetStatus

Énumérations VDS

VDS_DRIVE_PROP