Метод 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

См. также раздел

IUPnPDeviceFinder

IUPnPDeviceFinder::FindByType

IUPnPDevices