структура VDS_VOLUME_PROP2 (vds.h)

Статья
03/08/2023

[Начиная с 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

Массив байтов, содержащий уникальный идентификатор тома.

Если том находится в автономном режиме, флаг 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