IUPnPDeviceFinder::FindByUDN-Methode (upnp.h)
Die FindByUDN-Methode sucht synchron nach einem Gerät anhand seines eindeutigen Gerätenamens (UDN).
Syntax
HRESULT FindByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **pDevice
);
Parameter
[in] bstrUDN
Gibt den UDN an, nach dem gesucht werden soll. Bei diesem Wert wird die Groß-/Kleinschreibung beachtet und als Kleinbuchstaben angegeben (z. B. uuid:e8f85dfd-ff...).
[out] pDevice
Empfängt einen Verweis auf ein IUPnPDevice-Objekt , das das angeforderte Gerät enthält. Empfängt NULL , wenn das angegebene Gerät nicht gefunden wird.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode S_FALSE zurück.
Hinweise
Diese Methode gibt zurück, sobald ein Gerät gefunden wird, das dem angegebenen UDN entspricht. Wenn kein Gerät gefunden wird, dauert die Rückgabe der Methode mindestens neun Sekunden und möglicherweise länger.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |