Método IUPnPDescriptionDocument::D eviceByUDN (upnp.h)
El método DeviceByUDN devuelve el dispositivo con el nombre de dispositivo único (UDN) especificado incluido en el documento de descripción cargado.
Sintaxis
HRESULT DeviceByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **ppudDevice
);
Parámetros
[in] bstrUDN
Especifica el UDN del dispositivo.
[out] ppudDevice
Recibe una referencia a un objeto IUPnPDevice que describe el dispositivo. Esta referencia debe liberarse cuando ya no se use.
Valor devuelto
Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en WinError.h.
Comentarios
Use DeviceByUDN después de cargar la descripción del dispositivo mediante IUPnPDescriptionDocument::Load o IUPnPDescriptionDocument::LoadAsync. La propiedad IUPnPDescriptionDocument::ReadyState devuelve READYSTATE_COMPLETED.
No use DeviceByUDN a menos que se cargue primero una descripción del dispositivo mediante IUPnPDescriptionDocument::Load o IUPnPDescriptionDocument::LoadAsync. La operación de búsqueda solo busca en la descripción del dispositivo cargado actualmente.
Requisitos
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | upnp.h |
| Archivo DLL | Upnp.dll |