Метод IUPnPDescriptionDocument::D eviceByUDN (upnp.h)
Метод DeviceByUDN возвращает устройство с указанным уникальным именем устройства (UDN), содержащимся в загруженном документе описания.
Синтаксис
HRESULT DeviceByUDN(
[in] BSTR bstrUDN,
[out] IUPnPDevice **ppudDevice
);
Параметры
[in] bstrUDN
Указывает определяемый пользователем идентификатор устройства.
[out] ppudDevice
Получает ссылку на объект IUPnPDevice , описывающий устройство. Эта ссылка должна быть освобождена, когда она больше не используется.
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h.
Комментарии
Используйте DeviceByUDN после загрузки описания устройства с помощью IUPnPDescriptionDocument::Load или IUPnPDescriptionDocument::LoadAsync. Свойство IUPnPDescriptionDocument::ReadyState возвращает READYSTATE_COMPLETED.
Не используйте DeviceByUDN , если только описание устройства не загружено с помощью IUPnPDescriptionDocument::Load или IUPnPDescriptionDocument::LoadAsync. Операция поиска выполняет поиск только в описании загруженного устройства.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnp.h |
| DLL | Upnp.dll |