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

Метод IVdsSubSystem::Reenumerate (vds.h)

  • Статья

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

Предлагает подсистеме проверить шину, чтобы обнаружить недавно подключенные диски или недавно отключенные диски.

Синтаксис

HRESULT Reenumerate();

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

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

Возвращаемый код или значение Описание
VDS_E_PROVIDER_CACHE_CORRUPT
0x8004241FL
 Это возвращаемое значение сигнализирует о проблеме программного обеспечения или связи внутри поставщика, который кэширует сведения о массиве. Для восстановления кэша используйте метод IVdsHwProvider::Reenumerate , за которым следует метод IVdsHwProvider::Refresh .
VDS_E_OBJECT_DELETED
0x8004240BL
 Объект подсистемы больше не присутствует.
VDS_E_OBJECT_STATUS_FAILED
0x80042431L
 Подсистема находится в состоянии сбоя и не может выполнить запрошенную операцию.
VDS_E_ANOTHER_CALL_IN_PROGRESS
0x80042404L
 Выполняется другая операция; Эта операция не может продолжаться до завершения предыдущей операции или операций.

Комментарии

Большинство подсистем обнаруживают новые подключения и отключения автоматически. Однако для тех, кто этого не делает, этот метод предоставляет средства для запуска обнаружения вручную. Выполнение этой операции может занять много времени.

Когда этот метод обнаруживает только что подключенный диск, поставщик создает для него новый объект диска. Когда метод обнаруживает только что отключенный диск, поставщик сохраняет старый объект диска до удаления последней ссылки на VDS, а затем удаляет объект .

Каждый объект должен иметь уникальный и постоянный идентификатор. Идентификатор объекта должен быть допустимым ИДЕНТИФИКАТОРом GUID. Разработчики должны сохранять идентификатор объекта в каждой повторной записи, используя этот метод для объектов, которые существуют как до, так и после повторной записи.

Требования

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

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

IVdsHwProvider::Reenumerate

IVdsHwProvider::Refresh

IVdsLun::GetProperties

IVdsSubSystem