Compartir a través de

Método IWSDiscoveryProviderNotify::SearchFailed (wsddisco.h)

  • Artículo

Se llama a para indicar que se ha producido un error en una búsqueda iniciada por el usuario.

Sintaxis

HRESULT SearchFailed(
  [in]           HRESULT hr,
  [in, optional] LPCWSTR pszTag
);

Parámetros

[in] hr

Causa del error de búsqueda que inició esta devolución de llamada. Un valor de S_FALSE indica que la búsqueda se completó sin emitir devoluciones de llamada Add.

[in, optional] pszTag

Etiqueta de identificador opcional para esta búsqueda. Puede ser NULL.

Valor devuelto

El valor devuelto no es significativo. Un implementador debe devolver S_OK.

Comentarios

Se llama a SearchComplete si se han recibido correctamente respuestas.

Se llama a SearchFailed si una consulta iniciada por el usuario no da como resultado una respuesta. En este caso, el valor del parámetro hr será S_FALSE. SearchFailed se puede llamar opcionalmente si se producen errores en la transmisión intentada de la consulta, ya que la transmisión de consultas no es necesariamente sincrónica. pszTag coincidirá con la etiqueta proporcionada por el usuario de la consulta y se debe usar para identificar qué consulta no se pudo realizar.

El intervalo entre iniciar la búsqueda con SearchByType o SearchById y recibir una notificación SearchFailed es un máximo de 10 segundos, en función de MATCH_TIMEOUT de WS-Discovery y modificada por el Apéndice I de DPWS. El intervalo entre iniciar la búsqueda con SearchByAddress y la recepción de una notificación SearchFailed suele ser de 21 segundos, pero puede ser un máximo de 150 segundos.

Nota El proveedor puede realizar varias llamadas simultáneas a SearchFailed , por lo que es esencial que los datos compartidos se sincronicen en esta devolución de llamada.
 

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 wsdisco.h (incluya Wsdapi.h)
Archivo DLL Wsdapi.dll

Consulte también

IWSDiscoveryProviderNotify