Compartilhar via

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

  • Artigo

É chamado para indicar que uma pesquisa iniciada pelo usuário falhou.

Sintaxe

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

Parâmetros

[in] hr

Causa da falha de pesquisa que iniciou esse retorno de chamada. Um valor de S_FALSE indica a pesquisa concluída sem emitir nenhum retorno de chamada add.

[in, optional] pszTag

Marca de identificador opcional para esta pesquisa. Pode ser NULL.

Retornar valor

O valor retornado não é significativo. Um implementador deve retornar S_OK.

Comentários

SearchComplete será chamado se alguma resposta tiver sido recebida com êxito.

SearchFailed será chamado se uma consulta iniciada pelo usuário não resultar em uma resposta. Nesse caso, o valor do parâmetro hr será S_FALSE. SearchFailed pode ser chamado opcionalmente se ocorrerem erros na tentativa de transmissão da consulta, já que a transmissão de consulta não é necessariamente síncrona. pszTag corresponderá à marca fornecida pelo usuário da consulta e deverá ser usada para identificar qual consulta falhou.

O intervalo entre iniciar a pesquisa com SearchByType ou SearchById e receber uma notificação SearchFailed é de no máximo 10 segundos, com base em MATCH_TIMEOUT do WS-Discovery e alterado pelo Apêndice I do DPWS. O intervalo entre iniciar a pesquisa com SearchByAddress e o recebimento de uma notificação SearchFailed normalmente é de 21 segundos, mas pode ser no máximo 150 segundos.

Nota Várias chamadas simultâneas podem ser feitas para SearchFailed pelo provedor, portanto, é essencial que os dados compartilhados sejam sincronizados nesse retorno de chamada.
 

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 wsddisco.h (inclua Wsdapi.h)
DLL Wsdapi.dll

Confira também

IWSDiscoveryProviderNotify