Méthode IUPnPDeviceFinder ::FindByUDN (upnp.h)
La méthode FindByUDN recherche de manière synchrone un appareil par son nom d’appareil unique (UDN).
Syntaxe
HRESULT FindByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **pDevice
);
Paramètres
[in] bstrUDN
Spécifie l’UDN pour lequel rechercher. Cette valeur respecte la casse et doit être fournie en minuscules (par exemple, uuid :e8f85dfd-ff...).
[out] pDevice
Reçoit une référence à un objet IUPnPDevice qui contient l’appareil demandé. Reçoit la valeur NULL si l’appareil spécifié est introuvable.
Valeur retournée
Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne S_FALSE.
Remarques
Cette méthode retourne dès qu’un appareil qui correspond à l’UDN spécifié est trouvé. Si aucun appareil n’est trouvé, la méthode prend au moins neuf secondes pour retourner, et peut-être plus longtemps.
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 |