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

Voir aussi

IUPnPDeviceFinder

IUPnPDeviceFinder ::CreateAsyncFind

IUPnPDeviceFinderCallback