Compartilhar via


enumeração VDS_DRIVE_STATUS (vds.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Define o conjunto de valores de status de objeto para uma unidade.

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
Valor: 0
O status da unidade não pode ser determinado.
VDS_DRS_ONLINE
Valor: 1
A unidade está disponível e em uso. O valor VDS_HEALTH associado a essa unidade status pode ser qualquer valor, exceto VDS_H_FAILED.
VDS_DRS_NOT_READY
Valor: 2
A unidade está ocupada. O valor VDS_HEALTH pode ser qualquer valor, exceto VDS_H_FAILED.
VDS_DRS_OFFLINE
Valor: 4
A unidade está fisicamente presente, mas foi removida de seu grupo RAID ou pool de armazenamento. Por exemplo, se a unidade foi removida de seu grupo RAID porque falhou, a unidade status deverá ser VDS_DRS_FAILED. Se a unidade tiver sido removida como parte do rebalanceamento do armazenamento, a unidade status deverá ser VDS_DRS_OFFLINE.

Quando esse status de unidade é definido, uma notificação de VDS_NF_DRIVE_REMOVED é enviada.

O valor VDS_HEALTH pode ser qualquer valor.
VDS_DRS_FAILED
Valor: 5
A unidade falhou. O valor VDS_HEALTH deve ser VDS_H_FAILED ou VDS_H_FAILING.
VDS_DRS_REMOVED
Valor: 8
A unidade foi fisicamente desconectada do subsistema. Quando esse status é definido, uma notificação de VDS_NF_DRIVE_DEPART é enviada.

Windows Server 2008, Windows Vista e Windows Server 2003: Não há suporte para esse valor.

Comentários

O método IVdsDrive::SetStatus passa um valor VDS_DRIVE_STATUS como um argumento para definir o status de uma unidade e a estrutura VDS_DRIVE_PROP inclui um valor VDS_DRIVE_STATUS como membro para indicar o status atual.

Se o aplicativo encontrar um valor VDS_DRIVE_STATUS que não reconhece, ele deverá exibir a unidade status como desconhecida. Ele não deve tentar mapear a unidade não reconhecida status para outra unidade status.

Nota Constantes adicionais podem ser adicionadas à enumeração VDS_DRIVE_STATUS em versões futuras do Windows. Por esse motivo, seu aplicativo deve ser projetado para lidar normalmente com uma constante de enumeração VDS_DRIVE_STATUS não reconhecida.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho vds.h

Confira também

IVdsDrive::SetStatus

Enumerações VDS

VDS_DRIVE_PROP