Método IUPnPDescriptionDocument::D eviceByUDN (upnp.h)
O método DeviceByUDN retorna o dispositivo com o UDN (nome de dispositivo exclusivo) especificado contido no documento de descrição carregado.
Sintaxe
HRESULT DeviceByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **ppudDevice
);
Parâmetros
[in] bstrUDN
Especifica o UDN do dispositivo.
[out] ppudDevice
Recebe uma referência a um objeto IUPnPDevice que descreve o dispositivo. Essa referência deve ser liberada quando não for mais usada.
Valor retornado
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.
Comentários
Use DeviceByUDN depois de carregar a descrição do dispositivo usando IUPnPDescriptionDocument::Load ou IUPnPDescriptionDocument::LoadAsync. A propriedade IUPnPDescriptionDocument::ReadyState retorna READYSTATE_COMPLETED.
Não use DeviceByUDN , a menos que uma descrição do dispositivo seja carregada pela primeira vez usando IUPnPDescriptionDocument::Load ou IUPnPDescriptionDocument::LoadAsync. A operação de pesquisa pesquisa apenas na descrição do dispositivo carregada no momento.
Requisitos
| 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 |