Функция phoneSetData (tapi.h)

Статья
08/26/2023

Функция 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 на телефонное устройство. Формат данных, их значение для телефонного устройства и значение идентификатора данных зависят от поставщика услуг. Данные в буфере или выбор идентификатора данных могут выступать в качестве команд для телефонного устройства.