VDS_DISK_FLAG enumeração (vds.h)

Artigo
03/08/2023

[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 sinalizadores válidos para um objeto de disco.

Nota Exceto por VDS_DF_READ_ONLY, esses sinalizadores não podem ser definidos usando o método IVdsDisk::SetFlags ou limpos usando o método IVdsDisk::ClearFlags .

Syntax

typedef enum _VDS_DISK_FLAG {
  VDS_DF_AUDIO_CD = 0x1,
  VDS_DF_HOTSPARE = 0x2,
  VDS_DF_RESERVE_CAPABLE = 0x4,
  VDS_DF_MASKED = 0x8,
  VDS_DF_STYLE_CONVERTIBLE = 0x10,
  VDS_DF_CLUSTERED = 0x20,
  VDS_DF_READ_ONLY = 0x40,
  VDS_DF_SYSTEM_DISK = 0x80,
  VDS_DF_BOOT_DISK = 0x100,
  VDS_DF_PAGEFILE_DISK = 0x200,
  VDS_DF_HIBERNATIONFILE_DISK = 0x400,
  VDS_DF_CRASHDUMP_DISK = 0x800,
  VDS_DF_HAS_ARC_PATH = 0x1000,
  VDS_DF_DYNAMIC = 0x2000,
  VDS_DF_BOOT_FROM_DISK = 0x4000,
  VDS_DF_CURRENT_READ_ONLY = 0x8000,
  VDS_DF_REFS_NOT_SUPPORTED = 0x10000
} VDS_DISK_FLAG;

Constantes


`VDS_DF_AUDIO_CD` Valor: 0x1 A mídia em uma unidade CDROM ou DVD é um CD de áudio.
`VDS_DF_HOTSPARE` Valor: 0x2 O disco é reservado para uso somente como sobressalente frequente.
`VDS_DF_RESERVE_CAPABLE` Valor: 0x4 Esse sinalizador é reservado para uso futuro. Não use.
`VDS_DF_MASKED` Valor: 0x8 O disco é mascarado.
`VDS_DF_STYLE_CONVERTIBLE` Valor: 0x10 O estilo de partição no disco pode ser convertido entre MBR e GPT.
`VDS_DF_CLUSTERED` Valor: 0x20 O disco está clusterizado.
`VDS_DF_READ_ONLY` Valor: 0x40 Esse sinalizador indica que o atributo somente leitura do disco, que é mantido pelo sistema operacional Windows, está definido. Esse atributo pode ser definido usando o método IVdsDisk::SetFlags e limpo usando o método IVdsDisk::ClearFlags . Esse sinalizador e o atributo correspondente não refletem necessariamente o estado real somente leitura do disco, que é indicado pelo sinalizador VDS_DF_CURRENT_READ_ONLY . Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_SYSTEM_DISK` Valor: 0x80 O disco hospeda o volume atual do sistema. Se o disco for dinâmico e o volume for um espelho, o sinalizador será definido no disco que contém o plex que foi usado como o volume do sistema na inicialização. Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_BOOT_DISK` Valor: 0x100 O disco hospeda o volume de inicialização atual. Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_PAGEFILE_DISK` Valor: 0x200 O disco contém um arquivo de página. Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_HIBERNATIONFILE_DISK` Valor: 0x400 O disco contém o volume de hibernação. Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_CRASHDUMP_DISK` Valor: 0x800 O disco contém o volume crashdump. Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_HAS_ARC_PATH` Valor: 0x1000 O disco é visível para o computador na inicialização. Para GPT, esse sinalizador é definido para todos os discos. Para MBR, ele é definido apenas para discos visíveis para o firmware bios do computador. (Geralmente, esses são os primeiros 12 discos conectados ao computador e visíveis para o BIOS na inicialização.) Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_DYNAMIC` Valor: 0x2000 O disco é um disco dinâmico. Windows Vista e Windows Server 2003: Sem suporte antes do Windows Vista com SP1 e Windows Server 2008.
`VDS_DF_BOOT_FROM_DISK` Valor: 0x4000 Esse sinalizador é definido no disco rígido do qual o computador está configurado para iniciar. Em computadores que usam o firmware bios, esse é o primeiro disco rígido que o firmware detecta quando o computador é iniciado (dispositivo 80H ou 81H se 80H é atribuído a um dispositivo flash USB). Se o usuário conectar um dispositivo flash USB ao computador antes da inicialização, isso poderá fazer com que o dispositivo 80H seja atribuído ao dispositivo USB e pode fazer com que 81H seja atribuído ao primeiro disco rígido detectado pelo firmware. Observe que, nesse caso, esse sinalizador não está definido no dispositivo flash USB. Em computadores que usam a EFI (Interface de Firmware Estendido), esse sinalizador é definido no disco que contém a ESP (Partição do Sistema EFI) que foi usada para iniciar o computador. Observe que, se nenhum dos discos contiver um ESP ou se houver vários ESPs, esse sinalizador não será definido em nenhum dos discos. Windows Server 2008, Windows Vista e Windows Server 2003: Não há suporte para esse sinalizador.
`VDS_DF_CURRENT_READ_ONLY` Valor: 0x8000 Esse sinalizador indica que o disco está em um estado somente leitura. Se não estiver definido, o disco será de leitura/gravação. Ao contrário do sinalizador VDS_DF_READ_ONLY , que é usado para alterar o atributo somente leitura do disco mantido pelo sistema operacional Windows, esse sinalizador reflete o estado real do disco. Esse sinalizador não pode ser definido usando o método IVdsDisk::SetFlags ou limpo usando o método IVdsDisk::ClearFlags . O disco estará em um estado somente leitura se seu atributo somente leitura estiver definido. No entanto, um disco pode estar em um estado somente leitura mesmo que seu atributo somente leitura não esteja definido, se o hardware subjacente for somente leitura. Por exemplo, se o LUN estiver no estado somente leitura ou se o disco for um disco rígido virtual que reside em um volume somente leitura, o hardware subjacente será somente leitura e, portanto, o disco estará em um estado somente leitura. Windows Server 2008, Windows Vista e Windows Server 2003: Não há suporte para esse sinalizador.
`VDS_DF_REFS_NOT_SUPPORTED` Valor: 0x10000

Comentários

Essa enumeração fornece os valores para o membro ulFlags das estruturas VDS_DISK_PROP e VDS_DISK_PROP2 . A estrutura VDS_DISK_PROP é retornada pelo método IVdsDisk::GetProperties . A estrutura VDS_DISK_PROP2 é retornada pelo método IVdsDisk3::GetProperties2 .

Todos os valores do sinalizador VDS_DISK_FLAG são definidos pelo serviço VDS; eles não podem ser definidos por aplicativos. Uma exceção é o sinalizador VDS_DF_READ_ONLY , que pode ser definido usando o método IVdsDisk::SetFlags e limpo usando o método IVdsDisk::ClearFlags .

Discos USB e CD-ROMs têm as seguintes restrições e funcionalidades:

Não há suporte para discos dinâmicos em discos USB (incluindo discos rígidos removíveis USB e unidades flash USB).
Um disco USB removível não pode ser usado como um disco de inicialização.
Você pode criar um disco de RAM WinPE inicializável em uma unidade flash USB ou CD-ROM. Windows Server 2003: Sem suporte.
Uma unidade flash USB pode ter apenas uma partição. O tipo de partição pode ser MBR ou GPT.

Nota Constantes adicionais podem ser adicionadas à enumeração VDS_DISK_FLAG em versões futuras do Windows. Por esse motivo, seu aplicativo deve ser projetado para lidar normalmente com uma constante de enumeração VDS_DISK_FLAG 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