enumerazione VDS_VOLUME_FLAG (vds.h)

Articolo
03/13/2024

[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.

Definisce il set di flag validi per un oggetto volume.

Sintassi

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;

Costanti


`VDS_VF_SYSTEM_VOLUME` Valore: 0x1 Il volume è un volume di sistema.
`VDS_VF_BOOT_VOLUME` Valore: 0x2 Il volume è il volume di avvio.
`VDS_VF_ACTIVE` Valore: 0x4 Il volume è attivo. Vale a dire il valore bootIndicator dell'oggetto la partizione sottostante è impostata su true.
`VDS_VF_READONLY` Valore: 0x8 Il volume ha una lettera di unità e un NOME GUID del volume assegnato da Mount Manager e viene enumerato dalle funzioni FindFirstVolume e FindNextVolume . Tuttavia, il volume è di sola lettura. Questo flag non si applica ai dispositivi CD-ROM o DVD.
`VDS_VF_HIDDEN` Valore: 0x10 Il volume non ha una lettera di unità e un nome GUID del volume assegnato da Mount Manager. Il volume non viene enumerato dalle funzioni FindFirstVolume e FindNextVolume . Il volume può essere aperto usando il nome del dispositivo e il volume aperto può essere letto da o scritto in. Un esempio di nome di un dispositivo volume è \?\GLOBALROOT\Device\HarddiskVolumeX. Questo flag non si applica ai dispositivi CD-ROM o DVD.
`VDS_VF_CAN_EXTEND` Valore: 0x20 È possibile estendere le dimensioni del volume.
`VDS_VF_CAN_SHRINK` Valore: 0x40 Le dimensioni del volume possono essere ridotte.
`VDS_VF_PAGEFILE` Valore: 0x80 Il volume contiene un file di pagina.
`VDS_VF_HIBERNATION` Valore: 0x100 Il volume contiene un file di ibernazione.
`VDS_VF_CRASHDUMP` Valore: 0x200 Il volume contiene il file dump di arresto anomalo.
`VDS_VF_INSTALLABLE` Valore: 0x400 VDS crea una partizione hard in un volume dinamico che i chiamanti possono usare per installare un sistema operativo. La cancellazione di questo flag causa l'eliminazione della partizione. Questo flag può essere impostato o cancellato solo per i dischi dinamici; è sempre impostato per i dischi di base. Questo flag non si applica ai dispositivi CD-ROM o DVD.
`VDS_VF_LBN_REMAP_ENABLED` Valore: 0x800 VDS può modificare la posizione del volume sul disco in modo dinamico. Questo flag non è valido per basic o volumi dinamici e sono supportati solo da alcuni gestori di volumi di terze parti.
`VDS_VF_FORMATTING` Valore: 0x1000 Il volume viene formattato.
`VDS_VF_NOT_FORMATTABLE` Valore: 0x2000 Impossibile formattare il volume. Questo flag si applica a dispositivi di memoria portatili di piccole dimensioni, rimovibili dispositivi, dispositivi CDROM e dispositivi DVD. Per i dispositivi CD e DVD, questo è sempre impostato quando è presente un supporto nell'oggetto unità e non è impostata se non sono presenti supporti nell'unità.
`VDS_VF_NTFS_NOT_SUPPORTED` Valore: 0x4000 Il volume non supporta NTFS, ma può supportare altri file system. Questo flag si applica a piccole dimensioni dispositivi di memoria portatili, dispositivi rimovibili, dispositivi CDROM e dispositivi DVD.
`VDS_VF_FAT32_NOT_SUPPORTED` Valore: 0x8000 Il volume non supporta FAT32. Questo flag si applica a dispositivi di memoria portatili di piccole dimensioni, rimovibili dispositivi, dispositivi CDROM e dispositivi DVD.
`VDS_VF_FAT_NOT_SUPPORTED` Valore: 0x10000 Il volume non supporta FAT. Questo flag si applica a dispositivi di memoria portatili di piccole dimensioni, rimovibili dispositivi, dispositivi CDROM e dispositivi DVD.
`VDS_VF_NO_DEFAULT_DRIVE_LETTER` Valore: 0x20000 Il sistema operativo non assegna automaticamente una lettera di unità alla successiva aggiunta del volume al computer. Se cancellato, il sistema operativo assegna una lettera di unità al volume in alcune condizioni. Per GPT di base volumi, assegnazione o rimozione di una lettera di unità attivano questo flag. Questo flag non si applica ai dispositivi CD-ROM o DVD. Windows Server 2003: Nei volumi dinamici, questo flag viene sempre impostato e non può essere cancellato. Nei volumi di base è deselezionata per impostazione predefinita e può essere impostata o cancellata solo chiamando il metodo IVdsVolume::SetFlags o IVdsVolume::ClearFlags.
`VDS_VF_PERMANENTLY_DISMOUNTED` Valore: 0x40000 Il volume è non in linea. L'apertura del volume avrà esito positivo in un volume offline. Tuttavia, l'I/O rispetto a un volume offline avrà esito negativo. L'assegnazione di un percorso di accesso, ad esempio una lettera di unità, a un volume offline causa l'accesso online. Per impostare questo flag, chiamare IVdsVolumeMF::D ismount metodo, impostazione dei parametri bForce e bPermanent su TRUE. Questo flag non si applica ai dispositivi CD-ROM o DVD. Windows Server 2003: L'offlining dei volumi dinamici non è supportato. Quando un volume è offline, questo flag viene impostato nel membro ulFlags della struttura VDS_VOLUME_PROP e il flag di VDS_VS_OFFLINE viene impostato anche nel membro di stato della struttura VDS_VOLUME_PROP oVDS_VOLUME_PROP2 . Windows Server 2008, Windows Vista e Windows Server 2003: Il flag di VDS_VS_OFFLINE non è supportato.
`VDS_VF_PERMANENT_DISMOUNT_SUPPORTED` Valore: 0x80000 Il volume può essere preso offline.
`VDS_VF_SHADOW_COPY` Valore: 0x100000 Il volume è una copia shadow di un altro volume. Questo flag viene impostato quando viene creata la copia shadow. È cancellata quando la copia shadow viene interrotta dal volume originale. VDS_VF_SHADOW_COPY flag è un'indicazione per il software basato su driver di filtro file system (ad esempio programmi antivirus) per evitare l'associazione al . L'attributo può essere usato dalle applicazioni per distinguere i volumi di copia shadow dai volumi di produzione. Applicazioni che eseguire un ripristino rapido in cui viene eseguita una copia shadow LUN in una copia non shadow cancellando la sola lettura e nascosta bit dovrà cancellare anche questo bit. Questo flag non si applica ai dispositivi CD-ROM o DVD. Windows Server 2003: Questo flag non è supportato prima di Windows Server 2003 con SP1.
`VDS_VF_FVE_ENABLED` Valore: 0x200000 Il volume è protetto dalla crittografia full-volume di BitLocker. Questo flag non si applica ai dispositivi CD-ROM o DVD. Windows Server 2003: Questo flag non è supportato.
`VDS_VF_DIRTY` Valore: 0x400000 Il bit sporco del volume è impostato. Windows Server 2003: Questo flag non è supportato.
`VDS_VF_REFS_NOT_SUPPORTED` Valore: 0x800000
`VDS_VF_BACKS_BOOT_VOLUME` Valore: 0x1000000
`VDS_VF_BACKED_BY_WIM_IMAGE` Valore: 0x2000000

Commenti

In un disco di base MBR, i flag di volume possono essere impostati solo per l'intero disco, non per i singoli volumi.

Se il flag di VDS_VF_NO_DEFAULT_DRIVE_LETTER è impostato su un disco MBR, le lettere di unità esistenti vengono mantenute, ma non verranno assegnate nuove lettere di unità ai volumi sul disco.

Questa enumerazione fornisce valori per il membro ulFlags della struttura VDS_VOLUME_PROP e il parametro ulFlags dei metodi IVdsVolume::SetFlags e IVdsVolume::ClearFlags.

La tabella seguente confronta il comportamento del flag di VDS_VF_NO_DEFAULT_DRIVE_LETTER su dischi di base MBR, dischi di base GPT e dischi dinamici.

Funzionalità	Dischi di base MBR	Dischi di base GPT	Dischi dinamici MBR o GPT
Il flag VDS_VF_NO_DEFAULT_DRIVE_LETTER viene cancellato per impostazione predefinita. Tuttavia, questo flag può essere impostato chiamando IVdsVolume::SetFlags.	Sì.	Sì.	Sì. Windows Server 2003: Questo flag è sempre impostato per i dischi dinamici e non può essere cancellato.
Assegnazione o rimozione di una lettera di unità attiva l'impostazione del flag di VDS_VF_NO_DEFAULT_DRIVE_LETTER.	No, perché questo flag è impostato o cancellato per l'intero disco.	Sì, perché questo flag è impostato o cancellato per singoli volumi.	Sì. Windows Server 2003: Questo flag è sempre impostato per i dischi dinamici e non può essere cancellato.

Per creare un volume di avvio in un disco dinamico, è necessario impostare il flag di VDS_VF_INSTALLABLE per il volume e quindi formattare il volume chiamando il metodo IVdsVolumeMF::Format .

Nota È possibile aggiungere costanti aggiuntive all'enumerazione VDS_VOLUME_FLAG nelle versioni future di Windows. Per questo motivo, l'applicazione deve essere progettata per gestire correttamente una costante di enumerazione non riconosciuta VDS_VOLUME_FLAG.