énumération VDS_CONTROLLER_STATUS (vds.h)

Article
03/05/2025

[À compter de Windows 8 et Windows Server 2012, l’interface COM service de disque virtuel est remplacée par l’API de gestion du stockage Windows .]

Définit l’ensemble de valeurs d’état d’objet pour un contrôleur.

Syntaxe

typedef enum _VDS_CONTROLLER_STATUS {
  VDS_CS_UNKNOWN = 0,
  VDS_CS_ONLINE = 1,
  VDS_CS_NOT_READY = 2,
  VDS_CS_OFFLINE = 4,
  VDS_CS_FAILED = 5,
  VDS_CS_REMOVED = 8
} VDS_CONTROLLER_STATUS, *PVDS_CONTROLLER_STATUS;

Constantes


`VDS_CS_UNKNOWN` Valeur : 0 Impossible de déterminer l’état du contrôleur.
`VDS_CS_ONLINE` Valeur : 1 Le contrôleur est physiquement présent et en cours d’utilisation. La valeur VDS_HEALTH associée à cet état du contrôleur peut être n’importe quelle valeur, sauf VDS_H_FAILED.
`VDS_CS_NOT_READY` Valeur : 2 Le contrôleur est occupé. La valeur VDS_HEALTH peut être n’importe quelle valeur, sauf VDS_H_FAILED.
`VDS_CS_OFFLINE` Valeur : 4 Le contrôleur est physiquement présent, mais n’est pas disponible pour une utilisation. Par exemple, le contrôleur a été défini sur l’état inactif. Lorsque cet état du contrôleur est défini, une notification VDS_NF_CONTROLLER_REMOVED est envoyée. La valeur VDS_HEALTH peut être n’importe quelle valeur.
`VDS_CS_FAILED` Valeur : 5 Le contrôleur a échoué. La valeur VDS_HEALTH doit être VDS_H_FAILED ou VDS_H_FAILING.
`VDS_CS_REMOVED` Valeur : 8 Le contrôleur a été physiquement déconnecté du sous-système. Lorsque cet état est défini, une notification VDS_NF_CONTROLLER_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 IVdsController ::SetStatus transmet une valeur VDS_CONTROLLER_STATUS en tant qu’argument pour définir l’état d’un contrôleur, et la structure VDS_CONTROLLER_PROP inclut une valeur VDS_CONTROLLER_STATUS en tant que membre pour indiquer l’état actuel.

Si votre application rencontre une valeur VDS_CONTROLLER_STATUS qu’elle ne reconnaît pas, elle doit afficher l’état du contrôleur comme inconnu. Il ne doit pas tenter de mapper l’état du contrôleur non reconnu à un autre état du contrôleur.

Remarque Des constantes supplémentaires peuvent être ajoutées à l’énumération VDS_CONTROLLER_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_CONTROLLER_STATUS non reconnue.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	vds.h

Voir aussi

IVdsController ::SetStatus

énumérations VDS

VDS_CONTROLLER_PROP

Partager via