Metodo IWSDiscoveryProviderNotify::SearchFailed (wsddisco.h)

Articolo
03/04/2024

Viene chiamato per indicare che la ricerca avviata dall'utente non è riuscita.

Sintassi

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

Parametri

[in] hr

Causa dell'errore di ricerca che ha avviato questo callback. Un valore di S_FALSE indica che la ricerca è stata completata senza emettere alcun callback aggiuntivo.

[in, optional] pszTag

Tag identificatore facoltativo per questa ricerca. Può essere NULL.

Valore restituito

Il valore restituito non è significativo. Un implementer deve restituire S_OK.

Commenti

SearchComplete viene chiamato se sono state ricevute risposte.

SearchFailed viene chiamato se una query avviata dall'utente non genera una risposta. In questo caso, il valore del parametro hr sarà S_FALSE. SearchFailed può essere chiamato facoltativamente se si verificano errori nella trasmissione tentata della query, poiché la trasmissione di query non è necessariamente sincrona. pszTag corrisponderà al tag fornito dall'utente dalla query e deve essere usato per identificare la query non riuscita.

L'intervallo tra l'avvio della ricerca con SearchByType o SearchById e la ricezione di una notifica SearchFailed è un massimo di 10 secondi, basato su MATCH_TIMEOUT da WS-Discovery e modificato dall'appendice DPWS I. L'intervallo tra l'avvio della ricerca con SearchByAddress e la ricezione di una notifica SearchFailed è in genere 21 secondi, ma può essere un massimo di 150 secondi.

Nota È possibile effettuare più chiamate simultanee a SearchFailed dal provider, pertanto è essenziale sincronizzare i dati condivisi in questo callback.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wsddisco.h (include Wsdapi.h)
DLL	Wsdapi.dll

Vedi anche

IWSDiscoveryProviderNotify

Condividi tramite