VDS_VOLUME_PROP Struktur (vds.h)

Artikel
03/08/2023

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]

Definiert die Eigenschaften eines Volumeobjekts.

Syntax

typedef struct _VDS_VOLUME_PROP {
  VDS_OBJECT_ID        id;
  VDS_VOLUME_TYPE      type;
  VDS_VOLUME_STATUS    status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  ULONGLONG            ullSize;
  ULONG                ulFlags;
  VDS_FILE_SYSTEM_TYPE RecommendedFileSystemType;
  LPWSTR               pwszName;
} VDS_VOLUME_PROP, *PVDS_VOLUME_PROP;

Member

id

Die GUID des Volumes.

type

Ein VDS_VOLUME_TYPE Enumerationswert, der den Typ des Volumes angibt. Volumetypen sind einfach, überspannt, gestreift (RAID-0), gespiegelt oder mit Parität (RAID-5) gestreift.

status

Ein VDS_VOLUME_STATUS Enumerationswert, der den Status des Volumes angibt.

health

Ein VDS_HEALTH Enumerationswert, der den Integritätszustand des Volumes angibt.

TransitionState

Ein VDS_TRANSITION_STATE Enumerationswert, der den Übergangszustand des Volumes angibt.

ullSize

Die Größe des Volumes in Bytes.

ulFlags

Eine Bitmaske von VDS_VOLUME_FLAG Enumerationswerte, die das Volume beschreiben.

RecommendedFileSystemType

Ein VDS_FILE_SYSTEM_TYPE Enumerationswert, der das bevorzugte Dateisystem für das Volume angibt. Muss einer der folgenden Sein: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS oder VDS_FST_UNKNOWN.

pwszName

Der Name, der verwendet wird, um ein Handle für das Volume mit der CreateFile-Funktion zu öffnen. Beispiel: \?\GLOBALROOT\Device\HarddiskVolume1.

Bemerkungen

Die IVdsVolume::GetProperties-Methode gibt diese Struktur zurück, um die Eigenschaften eines Volumeobjekts zu melden.

Wenn ein Volume offline ist, wird das flag VDS_VF_PERMANENTLY_DISMOUNTED im ulFlags-Element der VDS_VOLUME_PROP-Struktur festgelegt, und der VDS_VS_OFFLINE Volumestatuswert wird auch im Statusmember dieser Struktur festgelegt.

Anforderungen


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