Метод IFunctionDiscoveryNotification::OnError (functiondiscoveryapi.h)

[Функция обнаружения доступна для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Получает ошибки, возникающие во время асинхронной обработки запросов.

Синтаксис

HRESULT OnError(
  [in] HRESULT        hr,
  [in] FDQUERYCONTEXT fdqcQueryContext,
  [in] const WCHAR    *pszProvider
);

Параметры

[in] hr

Ошибка запроса, о которой сообщается.

[in] fdqcQueryContext

Контекст, зарегистрированный для уведомления об изменениях. Тип FDQUERYCONTEXT определяется как DWORDLONG.

[in] pszProvider

Имя поставщика.

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

Реализация клиентской программы метода OnError должна возвращать вызывающей стороне одно из следующих значений HRESULT .

Код возврата	Описание
S_OK	Метод завершился успешно.
E_INVALIDARG	Недопустимое значение одного из входных параметров.

Комментарии

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

Не вызывайте Release для объекта запроса из этого метода. Это может привести к взаимоблокировку. Если метод Release вызывается для объекта запроса из другого потока во время обратного вызова, объект не будет освобожден до завершения обратного вызова.

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

Так как другие вызовы метода IFunctionDiscoveryNotification могут выполняться в других потоках, все изменения, внесенные в состояние потока во время вызова, необходимо восстановить перед выходом из метода .

Требования

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

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

IFunctionDiscoveryNotification