Функция phoneSetData (tapi.h)
Функция phoneSetData скачивает сведения из указанного буфера на открытое телефонное устройство по выбранному идентификатору данных.
Синтаксис
LONG phoneSetData(
HPHONE hPhone,
DWORD dwDataID,
LPVOID const lpData,
DWORD dwSize
);
Параметры
hPhone
Дескриптор на открытое телефонное устройство. Приложение должно быть владельцем телефона.
dwDataID
Место, где на телефонном устройстве нужно скачать буфер.
lpData
Указатель на расположение памяти, из которого нужно скачать данные.
dwSize
Размер буфера в байтах.
Возвращаемое значение
Возвращает положительный идентификатор запроса, если функция выполняется асинхронно, или отрицательный номер ошибки при возникновении ошибки. Параметр dwParam2 соответствующего сообщения PHONE_REPLY равен нулю при успешном выполнении функции или отрицательным номером ошибки при возникновении ошибки. Возможные возвращаемые значения:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALDATAID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPOINTER PHONEERR_UNINITIALIZED.
Комментарии
Функция phoneSetData загружает максимум байтов dwSize из lpData на телефонное устройство. Формат данных, их значение для телефонного устройства и значение идентификатора данных зависят от поставщика услуг. Данные в буфере или выбор идентификатора данных могут выступать в качестве команд для телефонного устройства.
Требования
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |