структура VDS_VOLUME_PROP2 (vds.h)
[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]
Определяет свойства объекта тома. Эта структура идентична структуре VDS_VOLUME_PROP , за исключением того, что она также включает идентификаторы GUID тома.
Синтаксис
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;
Члены
id
GUID тома.
type
Значение перечисления VDS_VOLUME_TYPE , указывающее тип тома. Типы томов: простые, чередуемые, чередующиеся (RAID-0), зеркальные или чередуемые с четностью (RAID-5).
status
Значение перечисления VDS_VOLUME_STATUS , указывающее состояние тома.
health
Значение перечисления VDS_HEALTH , указывающее состояние работоспособности тома.
TransitionState
Значение перечисления VDS_TRANSITION_STATE , указывающее состояние перехода тома.
ullSize
Размер тома в байтах.
ulFlags
Битовая маска VDS_VOLUME_FLAG значений перечисления, описывающих том.
RecommendedFileSystemType
Значение перечисления VDS_FILE_SYSTEM_TYPE , указывающее предпочтительную файловую систему для тома. Должен иметь одно из следующих значений: VDS_FST_NTFS, VDS_FST_FAT, VDS_FST_FAT32, VDS_FST_UDF, VDS_FST_CDFS или VDS_FST_UNKNOWN.
cbUniqueId
Длина массива байтов, на который указывает элемент pUniqueId .
pwszName
Имя, которое использовалось для открытия дескриптора тома с помощью функции CreateFile . Например, \?\GLOBALROOT\Device\HarddiskVolume1.
pUniqueId
Массив байтов, содержащий уникальный идентификатор тома.
Комментарии
Метод IVdsVolume2::GetProperties2 возвращает эту структуру для отчета о свойствах объекта тома.
Если том находится в автономном режиме, флаг VDS_VF_PERMANENTLY_DISMOUNTED устанавливается в элементе ulFlags структуры VDS_VOLUME_PROP2 , а значение состояния тома VDS_VS_OFFLINE также устанавливается в элементе состояния этой структуры.
Для томов GPT и динамических томов уникальный идентификатор, на который указывает элемент pUniqueId , является глобально уникальным.
Для съемных носителей том существует и имеет собственный уникальный идентификатор, даже если на устройстве нет носителя. Если том отформатирован на съемном носителе, он имеет собственный уникальный идентификатор. Дополнительные сведения см. в разделе Поддержка запросов диспетчера подключений в драйвере класса хранилища.
Формат уникального идентификатора может отличаться для разных типов устройств и томов. Для базовых томов на дисках MBR уникальный идентификатор основан на сигнатуре диска и смещения раздела. Так как сигнатура диска и смещение секции являются значениями DWORD, уникальный идентификатор не может быть гарантирован глобально уникальным на разных компьютерах.
При изменении сигнатуры диска изменяется и уникальный идентификатор тома. Изменения сигнатуры диска обычно происходят в результате конфликта во время клонирования диска.
Обратите внимание, что уникальный идентификатор отличается от пути GUID тома. Чтобы найти пути GUID тома, используйте метод IVdsVolumeMF3::QueryVolumeGuidPathnames .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Верхняя часть | vds.h |