Método IUPnPDeviceFinder::FindByUDN (upnp.h)
El método FindByUDN busca de forma sincrónica un dispositivo por su nombre de dispositivo único (UDN).
Sintaxis
HRESULT FindByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **pDevice
);
Parámetros
[in] bstrUDN
Especifica el UDN para el que se va a buscar. Este valor distingue mayúsculas de minúsculas y debe proporcionarse como minúsculas (por ejemplo, uuid:e8f85dfd-ff...).
[out] pDevice
Recibe una referencia a un objeto IUPnPDevice que contiene el dispositivo solicitado. Recibe NULL si no se encuentra el dispositivo especificado.
Valor devuelto
Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, el método devuelve S_FALSE.
Comentarios
Este método devuelve tan pronto como se encuentra un dispositivo que coincida con el UDN especificado. Si no se encuentra ningún dispositivo, el método tarda al menos nueve segundos en devolverse y, posiblemente, más tiempo.
Requisitos
Requisito | Value |
---|---|
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 |