IUPnPDescriptionDocument::D eviceByUDN-Methode (upnp.h)
Die DeviceByUDN-Methode gibt das Gerät mit dem angegebenen eindeutigen Gerätenamen (UDN) zurück, der im geladenen Beschreibungsdokument enthalten ist.
Syntax
HRESULT DeviceByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **ppudDevice
);
Parameter
[in] bstrUDN
Gibt den UDN des Geräts an.
[out] ppudDevice
Empfängt einen Verweis auf ein IUPnPDevice-Objekt , das das Gerät beschreibt. Dieser Verweis muss freigegeben werden, wenn er nicht mehr verwendet wird.
Rückgabewert
Wenn die Methode erfolgreich ist, wird der Rückgabewert S_OK. Andernfalls gibt die Methode einen der in WinError.h definierten COM-Fehlercodes zurück.
Hinweise
Verwenden Sie DeviceByUDN nach dem Laden der Gerätebeschreibung mithilfe von IUPnPDescriptionDocument::Load oder IUPnPDescriptionDocument::LoadAsync. Die IUPnPDescriptionDocument::ReadyState-Eigenschaft gibt READYSTATE_COMPLETED zurück.
Verwenden Sie DeviceByUDN nicht, es sei denn, eine Gerätebeschreibung wird zuerst mit IUPnPDescriptionDocument::Load oder IUPnPDescriptionDocument::LoadAsync geladen. Der Suchvorgang sucht nur in der aktuell geladenen Gerätebeschreibung.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |