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
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | upnp.h |
| DLL | Upnp.dll |