Метод IUPnPDeviceFinder::FindByType (upnp.h)

Метод FindByType выполняет синхронный поиск устройств по типу устройства или типу службы.

Синтаксис

HRESULT FindByType(
  [in]  BSTR         bstrTypeURI,
  [in]  DWORD        dwFlags,
  [out] IUPnPDevices **pDevices
);

Параметры

[in] bstrTypeURI

Указывает универсальный код ресурса (URI) типа устройства или службы, по которым выполняется поиск.

[in] dwFlags

Должен равняться нулю. Этот параметр зарезервирован для использования в будущем.

[out] pDevices

Получает ссылку на коллекцию обнаруженных устройств IUPnPDevices .

Возвращаемое значение

Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h.

Комментарии

Этот метод не возвращается до завершения поиска. Поиск может занять не менее девяти секунд и, возможно, больше. Этот метод не должен вызываться из потока, обрабатывающего сообщения пользовательского интерфейса.

Требования

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

IUPnPDeviceFinder

IUPnPDeviceFinder::FindByUDN

IUPnPDevices