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


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

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

Отменяет регистрацию интерфейса IVdsAdviseSink вызывающей стороны, чтобы вызывающий объект больше не получал уведомления от службы VDS.

Синтаксис

HRESULT Unadvise(
  [in] DWORD dwCookie
);

Параметры

[in] dwCookie

Файл cookie, возвращенный методом IVdsService::Advise при регистрации интерфейса IVdsAdviseSink .

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

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

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

Комментарии

Используйте метод Совет , чтобы зарегистрировать интерфейс IVdsAdviseSink приложения VDS для получения уведомлений от VDS. Совет возвращает файл cookie, который необходимо передать в качестве параметра в метод Unadvise .

Примечание Приложение, которое вызывает Функцию Совет , в конечном итоге должно вызвать Unadvise. В идеале он должен вызывать Unadvise , как только ему больше не нужно получать уведомления.
 
Метод Unadvise может вернуться не сразу, так как он ожидает, пока блокировка обновит список зарегистрированных клиентских приложений, и ожидает выхода потока уведомлений, отправляющего уведомления клиента. При наличии незаполненных уведомлений для отправки в приложение поток уведомлений пытается отправить их перед выходом.

Требования

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

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

IVdsAdviseSink

IVdsService

IVdsService::Совет

Уведомления VDS