Метод IVdsLunNumber::GetLunNumber (vds.h)

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

Извлекает номер LUN для LUN.

Синтаксис

HRESULT GetLunNumber(
  [out] ULONG *pulLunNumber
);

Параметры

[out] pulLunNumber

Адрес переменной, получающей номер LUN. Это значение является обязательным и не может иметь значение NULL.

Возвращаемое значение

Этот метод может возвращать стандартные значения HRESULT, такие как E_INVALIDARG или E_OUTOFMEMORY, а также возвращаемые значения VDS. Он также может возвращать преобразованные коды системных ошибок с помощью макроса HRESULT_FROM_WIN32 . Ошибки могут возникать из самого VDS или из используемого базового поставщика VDS . Возможные возвращаемые значения включают следующие.

Код возврата	Описание
S_OK	Метод завершился успешно.

Комментарии

Этот метод возвращает номер LUN, назначенный поставщику оборудования VDS LUN. Это число идентифицирует LUN в массиве дисков. Это не то же самое, что "Логический номер единицы" в адресе SCSI диска. Каждому LUN в массиве дисков назначается ровно один номер LUN.

Этот метод существует, так как служебная программа DiskRAID назначает каждому LUN собственный индекс при перечислении LUN в подсистеме. Но эти индексы могут изменяться при каждом запуске DiskRAID, если поставщик оборудования перечисляет LUN в другом порядке. Это может запутать конечных пользователей. Для дисковых массивов, имеющих собственные (назначенные поставщиком) номера LUN, этот метод дает вызывающему объекту возможность сопоставлять номера LUN с индексами LUN, назначенными DiskRAID.

Если подсистема поддерживает нумерации LUN, она может указать эту поддержку, установив флаг VDS_SF_SUPPORTS_LUN_NUMBER в элементе ulFlagsструктуры VDS_SUB_SYSTEM_PROP или VDS_SUB_SYSTEM_PROP2 . Дополнительные сведения об этом флаге см. в перечислении VDS_SUB_SYSTEM_FLAG .

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	vds.h
Библиотека	Uuid.lib

См. также раздел

IVdsLunNumber