VDS_VOLUME_PROP2 Struktur (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]
Definiert die Eigenschaften eines Volumeobjekts. Diese Struktur ist identisch mit der VDS_VOLUME_PROP-Struktur , mit der Ausnahme, dass sie auch die Volume-GUIDs enthält.
Syntax
typedef struct _VDS_VOLUME_PROP2 {
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;
ULONG cbUniqueId;
LPWSTR pwszName;
BYTE *pUniqueId;
} VDS_VOLUME_PROP2, *PVDS_VOLUME_PROP2;
Member
id
Die GUID des Volumes.
type
Ein VDS_VOLUME_TYPE Enumerationswert, der den Volumetyp angibt. Volumetypen sind einfach, überspannt, gestreift (RAID-0), gespiegelt oder mit Parität (RAID-5) gestreift.
status
Ein VDS_VOLUME_STATUS-Enumerationswert, der die status des Volumes angibt.
health
Ein VDS_HEALTH Enumerationswert, der den Integritätszustand des Volumes angibt.
TransitionState
Ein VDS_TRANSITION_STATE Enumerationswert, der den Übergangsstatus 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.
cbUniqueId
Die Länge des Bytearrays, auf das der pUniqueId-Member zeigt.
pwszName
Der Name, der zum Öffnen eines Handles für das Volume mit der CreateFile-Funktion verwendet wurde. Beispiel: \?\GLOBALROOT\Device\HarddiskVolume1.
pUniqueId
Ein Bytearray, das den eindeutigen Bezeichner für das Volume enthält.
Hinweise
Die IVdsVolume2::GetProperties2-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_PROP2-Struktur festgelegt, und der VDS_VS_OFFLINE volume status-Wert wird auch im status-Element dieser Struktur festgelegt.
Für GPT- und dynamische Volumes ist der eindeutige Bezeichner, auf den das pUniqueId-Element verweist, global eindeutig.
Für Wechselmedienlaufwerke ist das Volume vorhanden und verfügt über einen eigenen eindeutigen Bezeichner, auch wenn keine Medien auf dem Gerät vorhanden sind. Wenn ein Volume auf Wechselmedien formatiert ist, verfügt dieses Volume über einen eigenen eindeutigen Bezeichner. Weitere Informationen finden Sie unter Unterstützen von Einbindungs-Manager-Anforderungen in einem Speicherklassentreiber.
Das Format des eindeutigen Bezeichners kann zwischen verschiedenen Gerätetypen und Volumes variieren. Bei Basisvolumes auf MBR-Datenträgern basiert der eindeutige Bezeichner auf der Datenträgersignatur und dem Partitionsoffset. Da die Datenträgersignatur und der Partitionsoffset DWORD-Werte sind, kann nicht garantiert werden, dass der eindeutige Bezeichner computerübergreifend global eindeutig ist.
Wenn sich die Datenträgersignatur ändert, ändert sich auch der eindeutige Bezeichner des Volumes. Änderungen der Datenträgersignatur treten in der Regel als Folge einer Kollision während des Klonens von Datenträgern auf.
Beachten Sie, dass ein eindeutiger Bezeichner nicht mit einem Volume-GUID-Pfad identisch ist. Um die Volume-GUID-Pfade für ein Volume zu finden, verwenden Sie die IVdsVolumeMF3::QueryVolumeGuidPathnames-Methode .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Kopfzeile | vds.h |