Поделиться через

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

  • Статья

Метод OnLunEmpty вызывается всякий раз, когда VSS определяет, что теневая копия LUN не содержит интересных данных. Все теневые копии удалены (что также приводит к удалению LUN). Ресурсы LUN могут быть освобождены поставщиком и повторно использоваться для другой цели. VSS отключит все затронутые тома. Поставщик не должен выполнять повторное сканирование во время OnLunEmpty. VsS будет обрабатывать эту очистку.

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

Синтаксис

HRESULT OnLunEmpty(
  [in] VSS_PWSZ            wszDeviceName,
  [in] VDS_LUN_INFORMATION *pInformation
);

Параметры

[in] wszDeviceName

Устройство, соответствующее LUN, которое содержит теневое копирование, которое требуется удалить.

[in] pInformation

Указатель на структуру VDS_LUN_INFORMATION , содержащую сведения о LUN, содержав удаляемую теневое копирование.

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

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

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

Комментарии

Поставщики оборудования должны удалять теневые копии и восстанавливать LUN только в том случае, если
Вызывается OnLunEmpty . Аппаратное теневое копирование может использоваться в качестве носителя резервного копирования, поэтому LUN должны обрабатываться с той же осторожностью, что и массив хранения данных, используемых для обычных дисков. Восстановление LUN за пределами обработки для OnLunEmpty должно быть ограничено чрезвычайными ситуациями или администратором, выполняющим явные действия вручную.

В случае постоянных теневых копий запрашиватель удаляет теневую копию, когда она больше не нужна. В случае с теневыми копиями с неотложным автоматическим освобождением служба VSS удаляет теневую копию при вызове инициатором запроса IUnknown::Release в объекте IVssBackupComponents . В случае с теневыми копиями без автоматического выпуска служба VSS удаляет теневые копии при перезагрузке компьютера. Во всех случаях служба VSS вызывает метод OnLunEmpty поставщика по мере необходимости для каждого LUN теневой копии.

Обратите внимание, что OnLunEmpty вызывается по мере усилий. VSS вызывает метод только в том случае, если LUN гарантированно пуст. Во многих случаях LUN пуст, но СЛУЖБА VSS не может обнаружить это из-за ошибок или внешних обстоятельств. В этом случае пользователь должен использовать программное обеспечение для управления хранилищем, чтобы очистить это состояние.

Некоторые примеры.

  • Когда теневая копия LUN перемещается на другой узел, но фактически не транспортируется или не импортируется через VSS, этот LUN отображается как любой другой LUN, и тома можно просто удалить без уведомления о VSS.
  • Сбой или непредвиденная перезагрузка в середине создания теневой копии.
  • Отмененный импорт.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header vsprov.h

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

IVssHardwareSnapshotProvider