Метод IVssHardwareSnapshotProvider::LocateLuns (vsprov.h)

Статья
08/27/2023

Метод LocateLuns предлагает поставщику оборудования сделать теневые копии LUN видимыми для компьютера. Метод LocateLuns вызывается СЛУЖБой VSS при импорте набора теневых копий оборудования на компьютер. Поставщик несет ответственность за любое развертывание (или "всплывание") на аппаратном уровне.

Примечание Поставщики оборудования поддерживаются только в операционных системах Windows Server.

Синтаксис

HRESULT LocateLuns(
  [in] LONG                lLunCount,
  [in] VDS_LUN_INFORMATION *rgSourceLuns
);

Параметры

[in] lLunCount

Количество LUN, которые влияют на этот набор теневых копий.

[in] rgSourceLuns

Указатель на массив структур iLunCountVDS_LUN_INFORMATION , по одному для каждого LUN, который является частью импортируемого набора теневых копий.

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

Этот метод может возвращать одно из этих значений.

Возвращаемый код/значение	Описание
S_OK 0x00000000L	Операция успешно завершена.
E_OUTOFMEMORY 0x8007000EL	Нехватка памяти или других системных ресурсов.
E_INVALIDARG 0x80070057L	Одно из значений параметра недопустимо.
VSS_E_PROVIDER_VETO 0x80042306L	Произошла непредвиденная ошибка поставщика. Поставщик должен сообщить о событии в журнале событий приложения, предоставляя пользователю сведения о том, как устранить проблему.

В параметре 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