énumération VDS_DRIVE_STATUS (vdshwprv.h)

Article
03/03/2024

[À 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

Partager via