Метод IUPnPDevice::IconURL (upnp.h)
Метод IconURL возвращает URL-адрес, из которого можно загрузить значок указанного формата.
Синтаксис
HRESULT IconURL(
[in] BSTR bstrEncodingFormat,
[in] LONG lSizeX,
[in] LONG lSizeY,
[in] LONG lBitDepth,
[out] BSTR *pbstrIconURL
);
Параметры
[in] bstrEncodingFormat
Указывает тип MIME формата кодирования, запрашиваемого для значка.
[in] lSizeX
Задает ширину значка в пикселях. Стандартные значения: 16, 32 или 48.
[in] lSizeY
Указывает высоту значка в пикселях. Стандартные значения: 16, 32 или 48 пикселей.
[in] lBitDepth
Указывает битовую глубину значка. Стандартные значения: 8, 16 или 24.
[out] pbstrIconURL
Получает ссылку на строку, содержащую URL-адрес, с которого должен быть загружен значок. Отпустите эту строку с помощью SysFreeString , если она больше не требуется.
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет S_OK. В противном случае метод возвращает один из кодов com-ошибок, определенных в WinError.h.
Комментарии
Приложение может указать любые значения для lSizeX, lSizeY и lBitDepth. Тем не менее, нет никакой гарантии, что значок существует с этими спецификациями.
Если соответствующий значок не существует, возвращается URL-адрес значка, который наиболее точно соответствует указанному размеру и глубине бита.
Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnp.h |
| DLL | Upnp.dll |