Метод IVdsProviderPrivate::OnUnload (vdshwprv.h)

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

Предлагает объекту поставщика неинициализировать себя.

Синтаксис

HRESULT OnUnload(
  [in] BOOL bForceUnload
);

Параметры

[in] bForceUnload

Если значение равно true, VDS пытается принудительно выгрузить поставщика. Если значение равно false, VDS не предпринимает таких попыток.

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

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

Код возврата	Описание
S_OK	Поставщик выгружается.
S_FALSE	Поставщику не удается выгрузить в настоящее время. VDS попытается повторить попытку позже.

Комментарии

VDS вызывает этот метод непосредственно перед освобождением ссылки на объект поставщика. Когда число ссылок падает до нуля, поставщик выгружается. Если метод OnLoad завершается сбоем, VDS не вызывает OnUnload.

Примечания для разработчиков: Необходимо выполнить всю необходимую очистку даже без вызова OnUnload.

Требования

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

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

IVdsProviderPrivate

IVdsProviderPrivate::OnLoad