Метод IVssHardwareSnapshotProvider::LocateLuns (vsprov.h)
Метод LocateLuns предлагает поставщику оборудования сделать теневые копии LUN видимыми для компьютера. Метод LocateLuns вызывается СЛУЖБой VSS при импорте набора теневых копий оборудования на компьютер. Поставщик несет ответственность за любое развертывание (или "всплывание") на аппаратном уровне.
Синтаксис
HRESULT LocateLuns(
[in] LONG lLunCount,
[in] VDS_LUN_INFORMATION *rgSourceLuns
);
Параметры
[in] lLunCount
Количество LUN, которые влияют на этот набор теневых копий.
[in] rgSourceLuns
Указатель на массив структур iLunCountVDS_LUN_INFORMATION , по одному для каждого LUN, который является частью импортируемого набора теневых копий.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Возвращаемый код/значение | Описание |
|---|---|
|
Операция успешно завершена. |
|
Нехватка памяти или других системных ресурсов. |
|
Одно из значений параметра недопустимо. |
|
Произошла непредвиденная ошибка поставщика. Поставщик должен сообщить о событии в журнале событий приложения, предоставляя пользователю сведения о том, как устранить проблему. |
Комментарии
В параметре rgSourceLuns VSS предоставляет тот же массив структур VDS_LUN_INFORMATION , который поставщик ранее инициализировал в методе IVssHardwareSnapshotProvider::GetTargetLuns . Для каждой VDS_LUN_INFORMATION структуры в массиве поставщик должен снять маску (или "поверхность") соответствующую теневой копии LUN на компьютер.
Сразу после возврата этого метода VSS выполнит повторное сканирование и перечисление для обнаружения всех поступающих устройств. Это приводит к обнаружению любых предоставленных LUN диспетчером PnP. Параллельно с прослушивание поступлений диска VSS также будет прослушивать поступления скрытых томов. СЛУЖБА VSS перестанет прослушивать все тома, которые влияют на набор теневого копирования, появятся в системе или когда истекло время ожидания. Если некоторые устройства диска или тома не отображаются в этом окне, инициатору запроса будет сообщено, что служба VSS импортировала только некоторые теневые копии, возвращающие VSS_S_SOME_SNAPSHOTS_NOT_IMPORTED инициатору запроса. Инициатор запроса также получит ту же ошибку от VSS, если VDS_LUN_INFORMATION структуры, полученные из методов GetTargetLuns и IVssHardwareSnapshotProvider::FillInLunInfo , не совпадают.
Этот метод нельзя использовать для сопоставления теневых копий LUN как доступных только для чтения.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vsprov.h |