Método IFunctionDiscoveryNotification::OnError (functiondiscoveryapi.h)

[A Descoberta de Funções está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Recebe erros que ocorrem durante o processamento de consulta assíncrona.

Sintaxe

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

Parâmetros

[in] hr

O erro de consulta que está sendo relatado.

[in] fdqcQueryContext

O contexto registrado para notificação de alteração. O tipo FDQUERYCONTEXT é definido como um DWORDLONG.

[in] pszProvider

O nome do provedor.

Retornar valor

A implementação do programa cliente do método OnError deve retornar um dos seguintes valores HRESULT para o chamador.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
E_INVALIDARG	O valor de um dos parâmetros de entrada é inválido.

Comentários

Normalmente, os clientes esperam que qualquer erro assíncrono seja fatal e que a consulta pare de retornar resultados, mas a documentação do provedor personalizado pode indicar o contrário para códigos de erro específicos.

Não chame Release no objeto de consulta desse método. Fazer isso pode causar um deadlock. Se Release for chamado em um objeto de consulta de outro thread enquanto um retorno de chamada estiver em processo, o objeto não será liberado até que o retorno de chamada seja concluído.

Todas as notificações passadas para a Descoberta de Funções por provedores são enfileiradas e retornadas ao cliente uma a uma. Os retornos de chamada são sincronizados para que um cliente receba apenas uma notificação por vez.

Como outras chamadas de método IFunctionDiscoveryNotification podem ser feitas em outros threads, todas as alterações feitas no estado do thread durante a chamada devem ser restauradas antes de sair do método.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	functiondiscoveryapi.h

Confira também

IFunctionDiscoveryNotification