Метод IVdsService::Refresh (vds.h)

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

Обновляет сведения о владельце диска и макете диска.

Синтаксис

HRESULT Refresh();

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

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

Возвращаемый код/значение	Описание
S_OK	Метод завершился успешно.
S_FALSE	Во время этой операции произошла ошибка.
VDS_E_INITIALIZED_FAILED 0x80042401L	Не удалось инициализировать VDS. Если приложение вызывает этот метод до завершения инициализации службы, метод блокируется до завершения инициализации. Если инициализация завершается сбоем, возвращается эта ошибка.

Комментарии

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

Требования

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

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

IVdsService