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

[Detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Recibe errores que se producen durante el procesamiento asincrónico de consultas.

Sintaxis

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

Parámetros

[in] hr

Error de consulta que se está notificando.

[in] fdqcQueryContext

Contexto registrado para la notificación de cambios. El tipo FDQUERYCONTEXT se define como DWORDLONG.

[in] pszProvider

Nombre del proveedor.

Valor devuelto

La implementación del programa cliente del método OnError debe devolver uno de los siguientes valores HRESULT al autor de la llamada.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_INVALIDARG	El valor de uno de los parámetros de entrada no es válido.

Comentarios

Normalmente, los clientes esperarán que cualquier error asincrónico sea grave y que la consulta dejará de devolver resultados, pero la documentación del proveedor personalizado podría indicar lo contrario para códigos de error específicos.

No llame a Release en el objeto de consulta desde este método. Si lo hace, podría provocar un interbloqueo. Si se llama a Release en un objeto de consulta desde otro subproceso mientras se está procesando una devolución de llamada, el objeto no se liberará hasta que finalice la devolución de llamada.

Todas las notificaciones pasadas a la detección de funciones por proveedores se ponen en cola y se devuelven al cliente una por una. Las devoluciones de llamada se sincronizan para que un cliente solo reciba una notificación cada vez.

Dado que se pueden realizar otras llamadas al método IFunctionDiscoveryNotification en otros subprocesos, los cambios realizados en el estado del subproceso durante la llamada se deben restaurar antes de salir del método.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	functiondiscoveryapi.h

Consulte también

IFunctionDiscoveryNotification