Méthode IWSDiscoveryProviderNotify ::SearchFailed (wsddisco.h)
Est appelé pour indiquer qu’une recherche lancée par l’utilisateur a échoué.
Syntaxe
HRESULT SearchFailed(
[in] HRESULT hr,
[in, optional] LPCWSTR pszTag
);
Paramètres
[in] hr
Cause de l’échec de recherche à l’origine de ce rappel. La valeur S_FALSE indique que la recherche a été effectuée sans émettre de rappels d’ajout.
[in, optional] pszTag
Balise d’identificateur facultative pour cette recherche. Peut être NULL.
Valeur retournée
La valeur de retour n’est pas significative. Un implémenteur doit retourner S_OK.
Remarques
SearchComplete est appelé si des réponses ont été reçues avec succès.
SearchFailed est appelé si une requête lancée par l’utilisateur ne donne pas de réponse. Dans ce cas, la valeur du paramètre hr sera S_FALSE. SearchFailed peut éventuellement être appelé si des erreurs se produisent dans la tentative de transmission de la requête, car la transmission de la requête n’est pas nécessairement synchrone. pszTag correspond à la balise fournie par l’utilisateur à partir de la requête et doit être utilisé pour identifier la requête qui a échoué.
L’intervalle entre le lancement de la recherche avec SearchByType ou SearchById et la réception d’une notification SearchFailed est de 10 secondes au maximum, en fonction des MATCH_TIMEOUT de WS-Discovery et modifié par l’annexe I de DPWS. L’intervalle entre le lancement de la recherche avec SearchByAddress et la réception d’une notification SearchFailed est généralement de 21 secondes, mais peut être de 150 secondes au maximum.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | wsddisco.h (inclure Wsdapi.h) |
| DLL | Wsdapi.dll |