Freigeben über

VDS_VOLUME_FLAG Enumeration (vds.h)

  • Artikel

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Definiert den Satz gültiger Flags für ein Volumeobjekt.

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;

Konstanten

 
VDS_VF_SYSTEM_VOLUME
Wert: 0x1
Das Volume ist ein Systemvolume.
VDS_VF_BOOT_VOLUME
Wert: 0x2
Das Volume ist das Startvolume.
VDS_VF_ACTIVE
Wert: 0x4
Das Volume ist aktiv. Das heißt, der bootIndicator-Wert des
Die zugrunde liegende Partition ist auf true festgelegt.
VDS_VF_READONLY
Wert: 0x8
Das Volume verfügt über einen Laufwerkbuchstaben und einen vom Mount-Manager zugewiesenen Volume-GUID-Namen und wird von den Funktionen FindFirstVolume und FindNextVolume aufgelistet. Das Volume ist jedoch schreibgeschützt. Dieses Flag gilt nicht für CD-ROM- oder DVD-Geräte.
VDS_VF_HIDDEN
Wert: 0x10
Das Volume verfügt nicht über einen Laufwerkbuchstaben und einen vom Mount-Manager zugewiesenen Volume-GUID-Namen. Das Volume wird nicht durch die Funktionen FindFirstVolume und FindNextVolume aufgelistet. Das Volume kann mit seinem Gerätenamen geöffnet werden, und das geöffnete Volume kann gelesen oder in geschrieben werden. Ein Beispiel für einen Volumegerätenamen ist \?\GLOBALROOT\Device\HarddiskVolumeX. Dieses Flag gilt nicht für CD-ROM- oder DVD-Geräte.
VDS_VF_CAN_EXTEND
Wert: 0x20
Die Volumegröße kann erweitert werden.
VDS_VF_CAN_SHRINK
Wert: 0x40
Die Volumegröße kann reduziert werden.
VDS_VF_PAGEFILE
Wert: 0x80
Das Volume enthält eine Seitendatei.
VDS_VF_HIBERNATION
Wert: 0x100
Das Volume enthält eine Ruhezustandsdatei.
VDS_VF_CRASHDUMP
Wert: 0x200
Das Volume enthält die Absturzabbilddatei.
VDS_VF_INSTALLABLE
Wert: 0x400
VDS erstellt eine harte Partition unter einem dynamischen Volume, mit dem Anrufer ein Betriebssystem installieren können. Wenn Sie dieses Flag löschen, wird die Partition gelöscht. Dieses Flag kann nur für dynamische Datenträger festgelegt oder gelöscht werden. Sie ist immer für Basisdatenträger festgelegt. Dieses Flag gilt nicht für CD-ROM- oder DVD-Geräte.
VDS_VF_LBN_REMAP_ENABLED
Wert: 0x800
VDS kann die Position des Volumes auf dem Datenträger dynamisch ändern. Dieses Flag ist für basic ungültig.
oder dynamische Volumes und wird nur von einigen Volume-Managern von Drittanbietern unterstützt.
VDS_VF_FORMATTING
Wert: 0x1000
Das Volume wird formatiert.
VDS_VF_NOT_FORMATTABLE
Wert: 0x2000
Das Volume kann nicht formatiert werden. Dieses Flag gilt für kleine tragbare Speichergeräte, wechselbar
Geräte, CDROM-Geräte und DVD-Geräte. Bei CD- und DVD-Geräten wird dies immer dann festgelegt, wenn medien im
laufwerk, und ist nicht festgelegt, wenn keine Medien im Laufwerk vorhanden sind.
VDS_VF_NTFS_NOT_SUPPORTED
Wert: 0x4000
Das Volume unterstützt ntfs nicht, kann aber andere Dateisysteme unterstützen. Dieses Flag gilt für kleine
Tragbare Speichergeräte, Wechselmedien, CD-ROM-Geräte und DVD-Geräte.
VDS_VF_FAT32_NOT_SUPPORTED
Wert: 0x8000
Das Volume unterstützt FAT32 nicht. Dieses Flag gilt für kleine tragbare Speichergeräte, wechselbar
Geräte, CDROM-Geräte und DVD-Geräte.
VDS_VF_FAT_NOT_SUPPORTED
Wert: 0x10000
Fat wird vom Volume nicht unterstützt. Dieses Flag gilt für kleine tragbare Speichergeräte, wechselbar
Geräte, CDROM-Geräte und DVD-Geräte.
VDS_VF_NO_DEFAULT_DRIVE_LETTER
Wert: 0x20000
Das Betriebssystem weist keinen Laufwerkbuchstaben automatisch zu, wenn das Volume dem Computer das nächste Mal hinzugefügt wird.
Wenn dies deaktiviert ist, weist das Betriebssystem dem Volume unter bestimmten Bedingungen einen Laufwerkbuchstaben zu. Für grundlegende GPT
Volumes, das Zuweisen oder Entfernen eines Laufwerkbuchstabens wird dieses Flag umschalten. Dieses Flag gilt nicht für CD-ROM- oder DVD-Geräte.

Windows Server 2003: Auf dynamischen Volumes ist dieses Flag immer festgelegt und kann nicht gelöscht werden. Auf Basisvolumes wird sie standardmäßig gelöscht und kann nur durch Aufrufen der IVdsVolume::SetFlags - oder IVdsVolume::ClearFlags-Methode festgelegt oder gelöscht werden.
VDS_VF_PERMANENTLY_DISMOUNTED
Wert: 0x40000
Das Volume ist offline. Das geöffnete Volume wird auf einem Offlinevolume erfolgreich ausgeführt. Die E/A für ein Offlinevolume schlägt jedoch fehl. Das Zuweisen eines Zugriffspfads, z. B. eines Laufwerkbuchstabens, zu einem Offlinevolume führt dazu, dass es online wird. Um dieses Flag festzulegen, rufen Sie IVdsVolumeMF::D ismount auf.
method, festlegen der Parameter bForce und bPermanent auf
TRUE. Dieses Flag gilt nicht für CD-ROM- oder DVD-Geräte.

Windows Server 2003: Das Offlining von dynamischen Volumes wird nicht unterstützt.

Wenn ein Volume offline ist, wird dieses Flag im ulFlags-Member der VDS_VOLUME_PROP-Struktur festgelegt, und das VDS_VS_OFFLINE-Flag wird auch im status-Member der VDS_VOLUME_PROP- oder VDS_VOLUME_PROP2-Struktur festgelegt.Windows Server 2008, Windows Vista und Windows Server 2003: Das VDS_VS_OFFLINE-Flag wird nicht unterstützt.
VDS_VF_PERMANENT_DISMOUNT_SUPPORTED
Wert: 0x80000
Das Volume kann offline genommen werden.
VDS_VF_SHADOW_COPY
Wert: 0x100000
Das Volume ist eine Schattenkopie eines anderen Volumes. Dieses Flag wird festgelegt, wenn die Schattenkopie erstellt wird. Es handelt sich um
wird gelöscht, wenn die Schattenkopie vom ursprünglichen Volume unterbrochen wird. Die VDS_VF_SHADOW_COPY
flag ist ein Hinweis für dateisystemfiltertreiberbasierte Software (z. B.
Antivirenprogramme), um das Anfügen an die
formatiert. Das Attribut kann von Anwendungen verwendet werden, um Schattenkopievolumes von Produktionsvolumes zu unterscheiden. Anwendungen, die
Ausführen einer Schnellen Wiederherstellung, bei der eine Schattenkopie-LUN in eine Nicht-Schattenkopie erstellt wird, indem sie schreibgeschützt und ausgeblendet wird
Bit muss auch dieses Bit löschen. Dieses Flag gilt nicht für CD-ROM- oder DVD-Geräte.


Windows Server 2003: Dieses Flag wird vor Windows Server 2003 mit SP1 nicht unterstützt.
VDS_VF_FVE_ENABLED
Wert: 0x200000
Das Volume wird durch die BitLocker-Verschlüsselung des vollständigen Volumes geschützt. Dieses Flag gilt nicht für CD-ROM- oder DVD-Geräte.

Windows Server 2003: Dieses Flag wird nicht unterstützt.
VDS_VF_DIRTY
Wert: 0x400000
Das modifiziert Bit des Volumes ist festgelegt.

Windows Server 2003: Dieses Flag wird nicht unterstützt.
VDS_VF_REFS_NOT_SUPPORTED
Wert: 0x800000
VDS_VF_BACKS_BOOT_VOLUME
Wert: 0x1000000
VDS_VF_BACKED_BY_WIM_IMAGE
Wert: 0x2000000

Hinweise

Auf einem MBR-Basisdatenträger können Volumeflags nur für den gesamten Datenträger und nicht für einzelne Volumes festgelegt werden.

Wenn das flag VDS_VF_NO_DEFAULT_DRIVE_LETTER auf einem MBR-Datenträger festgelegt ist, werden alle vorhandenen Laufwerkbuchstaben beibehalten, aber den Volumes auf dem Datenträger werden keine neuen Laufwerkbuchstaben zugewiesen.

Diese Enumeration stellt Werte für den ulFlags-Member der VDS_VOLUME_PROP-Struktur und den ulFlags-Parameter der Methoden IVdsVolume::SetFlags und IVdsVolume::ClearFlags bereit.

In der folgenden Tabelle wird das Verhalten des VDS_VF_NO_DEFAULT_DRIVE_LETTER-Flags auf MBR-Basisdatenträgern, GPT-Basisdatenträgern und dynamischen Datenträgern verglichen.

Funktion MBR-Basisdatenträger GPT-Basisdatenträger DYNAMISCHE MBR- oder GPT-Datenträger
Das flag VDS_VF_NO_DEFAULT_DRIVE_LETTER ist standardmäßig deaktiviert. Dieses Flag kann jedoch durch Aufrufen von IVdsVolume::SetFlags festgelegt werden. Ja. Ja. Ja. Windows Server 2003: Dieses Flag ist für dynamische Datenträger immer festgelegt und kann nicht gelöscht werden.
Durch das Zuweisen oder Entfernen eines Laufwerkbuchstabens wird die Einstellung für das VDS_VF_NO_DEFAULT_DRIVE_LETTER-Flag umgeschaltet. Nein, da dieses Flag für den gesamten Datenträger festgelegt oder gelöscht wird. Ja, da dieses Flag für einzelne Volumes festgelegt oder gelöscht wird. Ja. Windows Server 2003: Dieses Flag ist für dynamische Datenträger immer festgelegt und kann nicht gelöscht werden.
 

Um ein Startvolume auf einem dynamischen Datenträger zu erstellen, müssen Sie das VDS_VF_INSTALLABLE-Flag für das Volume festlegen und das Volume dann formatieren, indem Sie die IVdsVolumeMF::Format-Methode aufrufen.

Hinweis In zukünftigen Windows-Versionen können der VDS_VOLUME_FLAG-Enumeration weitere Konstanten hinzugefügt werden. Aus diesem Grund muss Ihre Anwendung so konzipiert sein, dass sie eine nicht erkannte VDS_VOLUME_FLAG Enumerationskonstante ordnungsgemäß behandelt.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile vds.h

Weitere Informationen

IVdsVolume::ClearFlags

IVdsVolume::SetFlags

IVdsVolumeMF::D ismount

VDS-Enumerationen

VDS_PARTITION_INFO_MBR

VDS_SAN_POLICY

VDS_VOLUME_PROP