Compartilhar via

VDS_VOLUME_FLAG enumeração (vds.h)

  • Artigo

[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 volume.

Syntax

typedef enum _VDS_VOLUME_FLAG {
  VDS_VF_SYSTEM_VOLUME = 0x1,
  VDS_VF_BOOT_VOLUME = 0x2,
  VDS_VF_ACTIVE = 0x4,
  VDS_VF_READONLY = 0x8,
  VDS_VF_HIDDEN = 0x10,
  VDS_VF_CAN_EXTEND = 0x20,
  VDS_VF_CAN_SHRINK = 0x40,
  VDS_VF_PAGEFILE = 0x80,
  VDS_VF_HIBERNATION = 0x100,
  VDS_VF_CRASHDUMP = 0x200,
  VDS_VF_INSTALLABLE = 0x400,
  VDS_VF_LBN_REMAP_ENABLED = 0x800,
  VDS_VF_FORMATTING = 0x1000,
  VDS_VF_NOT_FORMATTABLE = 0x2000,
  VDS_VF_NTFS_NOT_SUPPORTED = 0x4000,
  VDS_VF_FAT32_NOT_SUPPORTED = 0x8000,
  VDS_VF_FAT_NOT_SUPPORTED = 0x10000,
  VDS_VF_NO_DEFAULT_DRIVE_LETTER = 0x20000,
  VDS_VF_PERMANENTLY_DISMOUNTED = 0x40000,
  VDS_VF_PERMANENT_DISMOUNT_SUPPORTED = 0x80000,
  VDS_VF_SHADOW_COPY = 0x100000,
  VDS_VF_FVE_ENABLED = 0x200000,
  VDS_VF_DIRTY = 0x400000,
  VDS_VF_REFS_NOT_SUPPORTED = 0x800000,
  VDS_VF_BACKS_BOOT_VOLUME = 0x1000000,
  VDS_VF_BACKED_BY_WIM_IMAGE = 0x2000000
} VDS_VOLUME_FLAG;

Constantes

 
VDS_VF_SYSTEM_VOLUME
Valor: 0x1
O volume é um volume do sistema.
VDS_VF_BOOT_VOLUME
Valor: 0x2
O volume é o volume de inicialização.
VDS_VF_ACTIVE
Valor: 0x4
O volume está ativo. Ou seja, o valor bootIndicator do
A partição subjacente é definida como true.
VDS_VF_READONLY
Valor: 0x8
O volume tem uma letra da unidade e um nome GUID de volume atribuído ao Mount Manager e é enumerado pelas funções FindFirstVolume e FindNextVolume . No entanto, o volume é somente leitura. Esse sinalizador não se aplica a dispositivos CD-ROM ou DVD.
VDS_VF_HIDDEN
Valor: 0x10
O volume não tem uma letra da unidade e um nome GUID de volume atribuído ao Gerenciador de Montagem. O volume não é enumerado pelas funções FindFirstVolume e FindNextVolume . O volume pode ser aberto usando o nome do dispositivo e o volume aberto pode ser lido ou gravado. Um exemplo de um nome de dispositivo de volume é \?\GLOBALROOT\Device\HarddiskVolumeX. Esse sinalizador não se aplica a dispositivos CD-ROM ou DVD.
VDS_VF_CAN_EXTEND
Valor: 0x20
O tamanho do volume pode ser estendido.
VDS_VF_CAN_SHRINK
Valor: 0x40
O tamanho do volume pode ser reduzido.
VDS_VF_PAGEFILE
Valor: 0x80
O volume contém um arquivo de página.
VDS_VF_HIBERNATION
Valor: 0x100
O volume contém um arquivo de hibernação.
VDS_VF_CRASHDUMP
Valor: 0x200
O volume contém o arquivo de despejo de memória.
VDS_VF_INSTALLABLE
Valor: 0x400
O VDS cria uma partição rígida em um volume dinâmico que os chamadores podem usar para instalar um sistema operacional. Limpar esse sinalizador faz com que a partição seja excluída. Esse sinalizador pode ser definido ou desmarcado somente para discos dinâmicos; ele é sempre definido para discos básicos. Esse sinalizador não se aplica a dispositivos CD-ROM ou DVD.
VDS_VF_LBN_REMAP_ENABLED
Valor: 0x800
O VDS pode alterar a posição do volume no disco dinamicamente. Esse sinalizador não é válido para básico
ou volumes dinâmicos e tem suporte apenas por alguns gerenciadores de volume de terceiros.
VDS_VF_FORMATTING
Valor: 0x1000
O volume está sendo formatado.
VDS_VF_NOT_FORMATTABLE
Valor: 0x2000
O volume não pode ser formatado. Esse sinalizador se aplica a pequenos dispositivos de memória portáteis, removíveis
dispositivos, dispositivos CDROM e dispositivos de DVD. Para dispositivos de CD e DVD, isso sempre é definido quando há mídia no
unidade e não será definido se não houver mídia na unidade.
VDS_VF_NTFS_NOT_SUPPORTED
Valor: 0x4000
O volume não dá suporte ao NTFS, mas pode dar suporte a outros sistemas de arquivos. Esse sinalizador se aplica a pequenos
dispositivos de memória portáteis, dispositivos removíveis, dispositivos CDROM e dispositivos de DVD.
VDS_VF_FAT32_NOT_SUPPORTED
Valor: 0x8000
O volume não dá suporte a FAT32. Esse sinalizador se aplica a pequenos dispositivos de memória portáteis, removíveis
dispositivos, dispositivos CDROM e dispositivos de DVD.
VDS_VF_FAT_NOT_SUPPORTED
Valor: 0x10000
O volume não dá suporte a FAT. Esse sinalizador se aplica a pequenos dispositivos de memória portáteis, removíveis
dispositivos, dispositivos CDROM e dispositivos de DVD.
VDS_VF_NO_DEFAULT_DRIVE_LETTER
Valor: 0x20000
O sistema operacional não atribui uma letra da unidade automaticamente na próxima vez que o volume for adicionado ao computador.
Se limpo, o sistema operacional atribui uma letra da unidade ao volume em algumas condições. Para GPT básico
volumes, atribuir ou remover uma letra da unidade alternará esse sinalizador. Esse sinalizador não se aplica a dispositivos CD-ROM ou DVD.

Windows Server 2003: Em volumes dinâmicos, esse sinalizador é sempre definido e não pode ser limpo. Em volumes básicos, ele é limpo por padrão e pode ser definido ou limpo apenas chamando o método IVdsVolume::SetFlags ou IVdsVolume::ClearFlags .
VDS_VF_PERMANENTLY_DISMOUNTED
Valor: 0x40000
O volume está offline. O volume aberto terá êxito em um volume offline. No entanto, a E/S em relação a um volume offline falhará. Atribuir um caminho de acesso, como uma letra da unidade, a um volume offline faz com que ele fique online. Para definir esse sinalizador, chame o IVdsVolumeMF::D ismount
método , definindo os parâmetros bForce e bPermanent como
TRUE. Esse sinalizador não se aplica a dispositivos CD-ROM ou DVD.

Windows Server 2003: Não há suporte para o offlining de volumes dinâmicos.

Quando um volume está offline, esse sinalizador é definido no membro ulFlags da estrutura VDS_VOLUME_PROP e o sinalizador VDS_VS_OFFLINE também é definido no membro status da estrutura VDS_VOLUME_PROP ou VDS_VOLUME_PROP2.Windows Server 2008, Windows Vista e Windows Server 2003: não há suporte para o sinalizador VDS_VS_OFFLINE.
VDS_VF_PERMANENT_DISMOUNT_SUPPORTED
Valor: 0x80000
O volume pode ser colocado offline.
VDS_VF_SHADOW_COPY
Valor: 0x100000
O volume é uma cópia de sombra de outro volume. Esse sinalizador é definido quando a cópia de sombra é criada. É
limpo quando a cópia de sombra é interrompida do volume original. O VDS_VF_SHADOW_COPY
sinalizador é uma indicação para software baseado em driver de filtro do sistema de arquivos (como
programas antivírus) para evitar a anexação ao
x: O atributo pode ser usado por aplicativos para diferenciar volumes de cópia de sombra de volumes de produção. Aplicativos que
executar uma Recuperação Rápida em que um LUN de cópia de sombra é transformado em uma cópia não sombra limpando o somente leitura e oculto
o bit também precisará limpar esse bit. Esse sinalizador não se aplica a dispositivos CD-ROM ou DVD.


Windows Server 2003: Não há suporte para esse sinalizador antes do Windows Server 2003 com SP1.
VDS_VF_FVE_ENABLED
Valor: 0x200000
O volume é protegido pela criptografia de volume completo do BitLocker. Esse sinalizador não se aplica a dispositivos CD-ROM ou DVD.

Windows Server 2003: Não há suporte para esse sinalizador.
VDS_VF_DIRTY
Valor: 0x400000
O bit sujo do volume está definido.

Windows Server 2003: Não há suporte para esse sinalizador.
VDS_VF_REFS_NOT_SUPPORTED
Valor: 0x800000
VDS_VF_BACKS_BOOT_VOLUME
Valor: 0x1000000
VDS_VF_BACKED_BY_WIM_IMAGE
Valor: 0x2000000

Comentários

Em um disco básico MBR, os sinalizadores de volume podem ser definidos apenas para o disco inteiro, não para volumes individuais.

Se o sinalizador VDS_VF_NO_DEFAULT_DRIVE_LETTER estiver definido em um disco MBR, todas as letras de unidade existentes serão preservadas, mas nenhuma nova letra da unidade será atribuída a volumes no disco.

Essa enumeração fornece valores para o membro ulFlags da estrutura VDS_VOLUME_PROP e o parâmetro ulFlags dos métodos IVdsVolume::SetFlags e IVdsVolume::ClearFlags .

A tabela a seguir compara o comportamento do sinalizador VDS_VF_NO_DEFAULT_DRIVE_LETTER em discos básicos MBR, discos básicos gpt e discos dinâmicos.

Recurso Discos básicos MBR Discos básicos de GPT Discos dinâmicos MBR ou GPT
O sinalizador VDS_VF_NO_DEFAULT_DRIVE_LETTER é limpo por padrão. No entanto, esse sinalizador pode ser definido chamando IVdsVolume::SetFlags. Sim. Sim. Sim. Windows Server 2003: Esse sinalizador é sempre definido para discos dinâmicos e não pode ser limpo.
Atribuir ou remover uma letra da unidade alterna a configuração do sinalizador VDS_VF_NO_DEFAULT_DRIVE_LETTER. Não, porque esse sinalizador está definido ou limpo para todo o disco. Sim, porque esse sinalizador está definido ou limpo para volumes individuais. Sim. Windows Server 2003: Esse sinalizador é sempre definido para discos dinâmicos e não pode ser limpo.
 

Para criar um volume de inicialização em um disco dinâmico, você deve definir o sinalizador VDS_VF_INSTALLABLE para o volume e formatar o volume chamando o método IVdsVolumeMF::Format .

Nota Constantes adicionais podem ser adicionadas à enumeração VDS_VOLUME_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_VOLUME_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

Confira também

IVdsVolume::ClearFlags

IVdsVolume::SetFlags

IVdsVolumeMF::D ismount

Enumerações do VDS

VDS_PARTITION_INFO_MBR

VDS_SAN_POLICY

VDS_VOLUME_PROP