Метод IUPnPDeviceFinder::FindByUDN (upnp.h)
Метод FindByUDN выполняет синхронный поиск устройства по уникальному имени устройства (UDN).
Синтаксис
HRESULT FindByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **pDevice
);
Параметры
[in] bstrUDN
Указывает имя пользователя, для которого выполняется поиск. Это значение учитывает регистр и должно быть указано в нижнем регистре (например, uuid:e8f85dfd-ff...).
[out] pDevice
Получает ссылку на объект IUPnPDevice , содержащий запрошенное устройство. Получает значение NULL , если указанное устройство не найдено.
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает S_FALSE.
Комментарии
Этот метод возвращается, как только будет найдено устройство, соответствующее указанному UDN. Если устройство не найдено, возврат метода занимает не менее девяти секунд и, возможно, дольше.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnp.h |
| DLL | Upnp.dll |