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

O método FindByUDN pesquisa de forma síncrona um dispositivo pelo seu nome de dispositivo exclusivo (UDN).

Sintaxe

HRESULT FindByUDN(
  [in]  BSTR        bstrUDN,
  [out] IUPnPDevice **pDevice
);

Parâmetros

[in] bstrUDN

Especifica a UDN para a qual pesquisar. Esse valor diferencia maiúsculas de minúsculas e deve ser fornecido como minúsculo (por exemplo, uuid:e8f85dfd-ff...).

[out] pDevice

Recebe uma referência a um objeto IUPnPDevice que contém o dispositivo solicitado. Recebe NULL se o dispositivo especificado não for encontrado.

Retornar valor

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará S_FALSE.

Comentários

Esse método retorna assim que um dispositivo que corresponde ao UDN especificado é encontrado. Se nenhum dispositivo for encontrado, o método levará pelo menos nove segundos para retornar e possivelmente mais tempo.

Requisitos

Confira também

Iupnpdevicefinder

IUPnPDeviceFinder::FindByType

IUPnPDevices