IUPnPDeviceFinderCallback ::SearchComplete, méthode (upnp.h)
La méthode SearchComplete est appelée par l’infrastructure UPnP pour informer l’application que la recherche initiale des périphériques réseau a été terminée.
Cette méthode est appelée lorsque l’infrastructure UPnP a terminé d’envoyer des rappels IUPnPDeviceFinderCallback ::D eviceAdded ou IUPnPDeviceFinderAddCallbackWithInterface ::D eviceAddedWithInterface pour tous les appareils présents sur le réseau au moment du démarrage de la recherche. Ces rappels reflètent l’état du réseau au moment du démarrage de la recherche.
Syntaxe
HRESULT SearchComplete(
[in] LONG lFindData
);
Paramètres
[in] lFindData
Spécifie la recherche pour laquelle l’infrastructure UPnP retourne des résultats. La valeur de lFindData est la valeur retournée à l’appelant par IUPnPDeviceFinder ::CreateAsyncFind.
Valeur retournée
L’application doit retourner S_OK.
Remarques
Cette méthode fournit simplement des informations. Elle n’indique pas que la recherche asynchrone est terminée, mais plutôt que la sonde initiale est terminée. La recherche asynchrone continue de signaler les appareils ajoutés au réseau et supprimés du réseau jusqu’à ce que l’application appelle IUPnPDeviceFinder ::CancelAsyncFind.
La recherche initiale peut prendre beaucoup de temps. Le rappel SearchComplete est appelé lorsque le document de description du dernier appareil trouvé (autrement dit, le dernier appareil trouvé sur le réseau au moment du démarrage de la recherche) a été chargé ou n’a pas pu être chargé.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | upnp.h |
| DLL | Upnp.dll |