Метод 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 . Возможные возвращаемые значения включают следующие.
Код возврата | Описание |
---|---|
|
Метод завершился успешно. |
Комментарии
Этот метод возвращает номер 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 |