VDS_DISK_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 Datenträgerobjekt.

Hinweis Mit Ausnahme von VDS_DF_READ_ONLY können diese Flags nicht mit der IVdsDisk::SetFlags-Methode festgelegt oder mit der IVdsDisk::ClearFlags-Methode gelöscht werden.
 

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;

Konstanten

 
VDS_DF_AUDIO_CD
Wert: 0x1
Das Medium in einem CD- oder DVD-Laufwerk ist eine Audio-CD.
VDS_DF_HOTSPARE
Wert: 0x2
Der Datenträger ist nur für die Verwendung als Hot Spare reserviert.
VDS_DF_RESERVE_CAPABLE
Wert: 0x4
Dieses Flag ist für die zukünftige Verwendung reserviert. Nicht verwenden.
VDS_DF_MASKED
Wert: 0x8
Der Datenträger ist maskiert.
VDS_DF_STYLE_CONVERTIBLE
Wert: 0x10
Der Partitionsstil auf dem Datenträger kann zwischen MBR und GPT konvertiert werden.
VDS_DF_CLUSTERED
Wert: 0x20
Der Datenträger ist gruppiert.
VDS_DF_READ_ONLY
Wert: 0x40
Dieses Flag gibt an, dass das schreibgeschützte Attribut des Datenträgers festgelegt ist, das vom Windows-Betriebssystem verwaltet wird. Dieses Attribut kann mithilfe der IVdsDisk::SetFlags-Methode festgelegt und mithilfe der IVdsDisk::ClearFlags-Methode gelöscht werden. Dieses Flag und das entsprechende Attribut geben nicht unbedingt den tatsächlichen schreibgeschützten Zustand des Datenträgers wider, der durch das VDS_DF_CURRENT_READ_ONLY-Flag angegeben wird.

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_SYSTEM_DISK
Wert: 0x80
Der Datenträger hostet das aktuelle Systemvolume. Wenn der Datenträger dynamisch ist und das Volume ein Spiegel ist, wird das Flag auf dem Datenträger festgelegt, der den Plex enthält, der beim Start als Systemvolume verwendet wurde.

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_BOOT_DISK
Wert: 0x100
Der Datenträger hostet das aktuelle Startvolume.

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_PAGEFILE_DISK
Wert: 0x200
Der Datenträger enthält eine Auslagerungsdatei.

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_HIBERNATIONFILE_DISK
Wert: 0x400
Der Datenträger enthält das Ruhezustandsvolume.

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_CRASHDUMP_DISK
Wert: 0x800
Der Datenträger enthält das Crashdump-Volume.

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_HAS_ARC_PATH
Wert: 0x1000
Der Datenträger ist beim Start für den Computer sichtbar. Für GPT ist dieses Flag für alle Datenträger festgelegt. Für MBR ist es nur für Datenträger festgelegt, die für die BIOS-Firmware des Computers sichtbar sind. (Dies sind in der Regel die ersten 12 Datenträger, die mit dem Computer verbunden und beim Start für das BIOS sichtbar sind.)

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_DYNAMIC
Wert: 0x2000
Der Datenträger ist ein dynamischer Datenträger.

Windows Vista und Windows Server 2003: Nicht unterstützt vor Windows Vista mit SP1 und Windows Server 2008.
VDS_DF_BOOT_FROM_DISK
Wert: 0x4000
Dieses Flag wird auf der Festplatte festgelegt, von der aus der Computer für den Start konfiguriert ist.

Auf Computern, die die BIOS-Firmware verwenden, ist dies die erste Festplatte, die die Firmware erkennt, wenn der Computer gestartet wird (Gerät 80H oder 81H, wenn 80H einem USB-Flashgerät zugewiesen ist). Wenn der Benutzer vor dem Start ein USB-Flash-Gerät an den Computer einbindet, kann dies dazu führen, dass dem USB-Gerät 80H zugewiesen wird und 81H die erste festplatte zugewiesen wird, die von der Firmware erkannt wurde. Beachten Sie, dass dieses Flag in diesem Fall nicht auf dem USB-Flashgerät festgelegt ist.

Auf Computern, die die erweiterte Firmware-Schnittstelle (EFI) verwenden, wird dieses Flag auf dem Datenträger festgelegt, der die EFI-Systempartition (ESP) enthält, die zum Starten des Computers verwendet wurde. Beachten Sie, dass dieses Flag auf keinem der Datenträger festgelegt ist, wenn keiner der Datenträger ein ESP enthält oder mehrere ESPs vorhanden sind. Windows Server 2008, Windows Vista und Windows Server 2003: Dieses Flag wird nicht unterstützt.
VDS_DF_CURRENT_READ_ONLY
Wert: 0x8000
Dieses Flag gibt an, dass sich der Datenträger in einem schreibgeschützten Zustand befindet. Wenn er nicht festgelegt ist, ist der Datenträger Lese-/Schreibzugriff. Im Gegensatz zum VDS_DF_READ_ONLY-Flag , das verwendet wird, um das schreibgeschützte Attribut des Datenträgers zu ändern, das vom Windows-Betriebssystem verwaltet wird, gibt dieses Flag den tatsächlichen Datenträgerstatus wider. Dieses Flag kann nicht mit der IVdsDisk::SetFlags-Methode festgelegt oder mit der IVdsDisk::ClearFlags-Methode gelöscht werden.

Der Datenträger befindet sich in einem schreibgeschützten Zustand, wenn sein schreibgeschütztes Attribut festgelegt ist. Ein Datenträger kann sich jedoch in einem schreibgeschützten Zustand befinden, auch wenn sein schreibgeschütztes Attribut nicht festgelegt ist, wenn die zugrunde liegende Hardware schreibgeschützt ist. Wenn sich die LUN beispielsweise im schreibgeschützten Zustand befindet oder es sich bei dem Datenträger um eine virtuelle Festplatte handelt, die sich auf einem volume befindet, das schreibgeschützt ist, ist die zugrunde liegende Hardware schreibgeschützt, und daher befindet sich der Datenträger in einem schreibgeschützten Zustand. Windows Server 2008, Windows Vista und Windows Server 2003: Dieses Flag wird nicht unterstützt.
VDS_DF_REFS_NOT_SUPPORTED
Wert: 0x10000

Hinweise

Diese Enumeration stellt die Werte für das ulFlags-Element der VDS_DISK_PROP - und VDS_DISK_PROP2-Strukturen bereit. Die VDS_DISK_PROP-Struktur wird von der IVdsDisk::GetProperties-Methode zurückgegeben. Die VDS_DISK_PROP2-Struktur wird von der IVdsDisk3::GetProperties2-Methode zurückgegeben.

Alle VDS_DISK_FLAG-Flagwerte werden vom VDS-Dienst festgelegt. Sie können nicht von Anwendungen festgelegt werden. Eine Ausnahme ist das VDS_DF_READ_ONLY-Flag , das mithilfe der IVdsDisk::SetFlags-Methode festgelegt und mithilfe der IVdsDisk::ClearFlags-Methode gelöscht werden kann.

USB-Datenträger und CD-ROMs verfügen über die folgenden Einschränkungen und Funktionen:

  • Dynamische Datenträger werden auf USB-Datenträgern (einschließlich USB-Wechseldatenträgern und USB-Flashlaufwerken) nicht unterstützt.
  • Ein USB-Wechseldatenträger kann nicht als Startdatenträger verwendet werden.
  • Sie können einen startbaren WinPE-RAM-Datenträger auf einem USB-Flashlaufwerk oder cd-ROM erstellen. Windows Server 2003: Nicht unterstützt.
  • Ein USB-Flashlaufwerk kann nur eine Partition aufweisen. Der Partitionstyp kann MBR oder GPT sein.
Hinweis In zukünftigen Windows-Versionen können der VDS_DISK_FLAG-Enumeration zusätzliche Konstanten hinzugefügt werden. Aus diesem Grund muss Ihre Anwendung so konzipiert sein, dass sie eine nicht erkannte VDS_DISK_FLAG Enumerationskonstante ordnungsgemäß verarbeitet.
 

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

IVdsDisk3::GetProperties2

IVdsDisk::ClearFlags

IVdsDisk::GetProperties

IVdsDisk::SetFlags

VDS_DISK_PROP

VDS_DISK_PROP2