структура VDS_LUN_PROP (vdshwprv.h)

Статья
03/08/2023

[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков замечается API управления хранилищем Windows.]

Определяет свойства объекта LUN.

Синтаксис

typedef struct _VDS_LUN_PROP {
  VDS_OBJECT_ID        id;
  ULONGLONG            ullSize;
  LPWSTR               pwszFriendlyName;
  LPWSTR               pwszIdentification;
  LPWSTR               pwszUnmaskingList;
  ULONG                ulFlags;
  VDS_LUN_TYPE         type;
  VDS_LUN_STATUS       status;
  VDS_HEALTH           health;
  VDS_TRANSITION_STATE TransitionState;
  SHORT                sRebuildPriority;
} VDS_LUN_PROP, *PVDS_LUN_PROP;

Члены

id

GUID объекта LUN.

ullSize

Размер LUN в байтах.

pwszFriendlyName

Имя LUN; строка с нулевым завершением, читаемая человеком.

pwszIdentification

Уникальный идентификатор LUN; строка с нулевым завершением, читаемая человеком.

pwszUnmaskingList

Список, указывающий компьютеры в сети, которым будет предоставлен доступ к LUN; строка с разделителями точками с запятой, заканчивающаяся null и читаемая человеком строка.

Если значение равно "*", доступ к LUN должен быть предоставлен всем компьютерам в сети. Если значение равно "", компьютеры не должны предоставлять доступ к LUN.

Примечание На практике, если значение равно "*", большинство поставщиков оборудования предоставляют доступ к LUN только портам и инициаторам на локальном компьютере.

Если задано значение "*" или "", другое значение не может быть указано.

Для сетей Fibre Channel и сетей с последовательным подключением SCSI (SAS) каждая запись представляет собой 64-разрядное имя (WWN) каждого порта, к которому не маскируется LUN, отформатированная в виде шестнадцатеричной строки (длиной 16 символов), наиболее важной из которых является байт. Например, адрес WWN 01:23:45:67:89:AB:CD:EF представлен как "0123456789ABCDEF". Дополнительные сведения см. в спецификациях T10 для Fibre Channel и SAS.

Для сетей iSCSI каждая запись представляет собой полное имя iSCSI (IQN) каждого инициатора, которому не маскируется LUN. Считается, что lun, не маски для определенного инициатора, связан с этим инициатором.

Примечание Список unmasking может содержать один и тот же WWN или IQN несколько раз. Дубликаты игнорируются.

ulFlags

Флаги LUN, перечисляемые VDS_LUN_FLAG.

type

Тип LUN, перечисляемый VDS_LUN_TYPE.

status

Состояние объекта LUN, перечисляемого VDS_LUN_STATUS.

health

Значение перечисления VDS_HEALTH , указывающее состояние работоспособности LUN. Ниже приведены допустимые значения для этого элемента.

VDS_H_UNKNOWN (0)

VDS_H_HEALTHY (1)

VDS_H_REBUILDING (2)

VDS_H_FAILING (4)

VDS_H_FAILING_REDUNDANCY (5)

VDS_H_FAILED_REDUNDANCY (6)

VDS_H_FAILED_REDUNDANCY_FAILING (7)

VDS_H_FAILED (8)

TransitionState

Состояние перехода LUN, перечисленное VDS_TRANSITION_STATE.

sRebuildPriority

Приоритет перестроения объекта LUN. Значение от 0 (самый низкий приоритет) до 15 (наивысший приоритет).

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	vdshwprv.h