Функция phoneGetIcon (tapi.h)
Функция phoneGetIcon позволяет приложению получить значок для устройства (или поставщика), который может отображаться для пользователя.
Синтаксис
LONG phoneGetIcon(
DWORD dwDeviceID,
LPCSTR lpszDeviceClass,
LPHICON lphIcon
);
Параметры
dwDeviceID
Идентификатор устройства телефона, значок которого запрашивается.
lpszDeviceClass
Указатель на строку, завершающуюся значением NULL, которая идентифицирует имя класса устройства. Этот класс устройства позволяет приложению выбрать определенный вложенный значок, применимый к этому классу устройства. Этот параметр является необязательным и может оставить значение NULL или пустой. В этом случае будет выбран значок самого высокого уровня, связанный с телефонным устройством, а не с указанным устройством потока мультимедиа.
lphIcon
Указатель на расположение памяти, в котором возвращается дескриптор значка.
Возвращаемое значение
Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_BADDEVICEID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_NOMEM PHONEERR_NODEVICE.
Комментарии
Функция phoneGetIcon заставляет поставщика возвращать дескриптор (в lphIcon) ресурсу значка (полученному из LoadIcon), связанному с указанным телефоном. Дескриптор значка предназначен для ресурса, связанного с поставщиком; Приложение должно использовать CopyIcon , если оно хочет ссылаться на значок после выгрузки поставщика, что вряд ли произойдет, если приложение открыто на телефоне.
Параметр lpszDeviceClass позволяет поставщику возвращать различные значки в зависимости от типа службы, на которую ссылается вызывающий объект. Допустимые строки такие же, как и для phoneGetID. Например, если телефон поддерживает API Comm, передача "COMM" как lpszDeviceClass приводит к тому, что поставщик возвращает значок, связанный с функциями устройства Comm поставщика услуг. Параметры "tapi/phone", "" или NULL можно использовать для запроса значка для телефонной службы.
Если для приложений, использующих версию TAPI более ранней, чем 2.0, поставщик не возвращает значок (из-за того, что данный класс устройства является недопустимым или поставщик не поддерживает значки), TAPI заменяет универсальный значок телефонного устройства телефонии. Для приложений, использующих TAPI версии 2.0 или более поздней, TAPI заменяет значок телефона по умолчанию, только если параметр lpszDeviceClass имеет значение "tapi/phone", "" или NULL. Для любого другого класса устройства, если данный класс устройства недопустим или поставщик не поддерживает значки для класса, phoneGetIcon возвращает PHONEERR_INVALDEVICECLASS.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |