Método IUPnPDeviceFinder::FindByUDN (upnp.h)

  • Artículo

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

Consulte también

IUPnPDeviceFinder

IUPnPDeviceFinder::FindByType

IUPnPDevices