Méthode IUPnPDescriptionDocument::D eviceByUDN (upnp.h)
La méthode DeviceByUDN retourne l’appareil avec le nom d’appareil unique (UDN) spécifié dans le document de description chargé.
Syntaxe
HRESULT DeviceByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **ppudDevice
);
Paramètres
[in] bstrUDN
Spécifie l’UDN de l’appareil.
[out] ppudDevice
Reçoit une référence à un objet IUPnPDevice qui décrit l’appareil. Cette référence doit être publiée lorsqu’elle n’est plus utilisée.
Valeur retournée
Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h.
Remarques
Utilisez DeviceByUDN après avoir chargé la description de l’appareil à l’aide de IUPnPDescriptionDocument::Load ou IUPnPDescriptionDocument::LoadAsync. La propriété IUPnPDescriptionDocument::ReadyState retourne READYSTATE_COMPLETED.
N’utilisez pas DeviceByUDN sauf si une description d’appareil est d’abord chargée à l’aide de IUPnPDescriptionDocument::Load ou IUPnPDescriptionDocument::LoadAsync. L’opération de recherche recherche uniquement dans la description de l’appareil actuellement chargée.
Configuration requise
| 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 |