VDS_VOLUME_FLAG Enumeration (vds.h)
[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_VOLUMEWert: 0x1 Das Volume ist ein Systemvolume. |
VDS_VF_BOOT_VOLUMEWert: 0x2 Das Volume ist das Startvolume. |
VDS_VF_ACTIVEWert: 0x4 Das Volume ist aktiv. Das heißt, der bootIndicator-Wert des Die zugrunde liegende Partition ist auf true festgelegt. |
VDS_VF_READONLYWert: 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_HIDDENWert: 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_EXTENDWert: 0x20 Die Volumegröße kann erweitert werden. |
VDS_VF_CAN_SHRINKWert: 0x40 Die Volumegröße kann reduziert werden. |
VDS_VF_PAGEFILEWert: 0x80 Das Volume enthält eine Seitendatei. |
VDS_VF_HIBERNATIONWert: 0x100 Das Volume enthält eine Ruhezustandsdatei. |
VDS_VF_CRASHDUMPWert: 0x200 Das Volume enthält die Absturzabbilddatei. |
VDS_VF_INSTALLABLEWert: 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_ENABLEDWert: 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_FORMATTINGWert: 0x1000 Das Volume wird formatiert. |
VDS_VF_NOT_FORMATTABLEWert: 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_SUPPORTEDWert: 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_SUPPORTEDWert: 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_SUPPORTEDWert: 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_LETTERWert: 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_DISMOUNTEDWert: 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_SUPPORTEDWert: 0x80000 Das Volume kann offline genommen werden. |
VDS_VF_SHADOW_COPYWert: 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_ENABLEDWert: 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_DIRTYWert: 0x400000 Das modifiziert Bit des Volumes ist festgelegt. Windows Server 2003: Dieses Flag wird nicht unterstützt. |
VDS_VF_REFS_NOT_SUPPORTEDWert: 0x800000 |
VDS_VF_BACKS_BOOT_VOLUMEWert: 0x1000000 |
VDS_VF_BACKED_BY_WIM_IMAGEWert: 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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für