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

Voir aussi

IUPnPDescriptionDocument

IUPnPDevice