Функция lineSetAppSpecific (tapi.h)
Функция lineSetAppSpecific позволяет приложению задать для конкретного приложения поле записи сведений о вызове указанного вызова.
Синтаксис
LONG lineSetAppSpecific(
HCALL hCall,
DWORD dwAppSpecific
);
Параметры
hCall
Обработайте вызов, поле которого необходимо задать для конкретного приложения. Приложение должно быть владельцем вызова. Состояние вызова hCall может быть любым.
dwAppSpecific
Новое содержимое элемента dwAppSpecific для структуры LINECALLINFO вызова. Это значение не интерпретируется API телефонии.
Возвращаемое значение
Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_NOTOWNER, LINEERR_OPERATIONUNAVAIL LINEERR_OPERATIONFAILED.
Комментарии
Поле конкретного приложения в структуре данных LINECALLINFO , которое существует для каждого вызова, не интерпретируется API телефонии или любым из его поставщиков услуг. Его использование полностью определяется приложениями. Поле можно считать из записи LINECALLINFO , возвращаемой lineGetCallInfo. Однако для задания поля необходимо использовать lineSetAppSpecific , чтобы изменения стали видимыми для других приложений. При изменении этого поля всем остальным приложениям с дескрипторами вызовов отправляется сообщение LINE_CALLINFO с указанием изменения члена dwAppSpecific .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tapi.h |
| Библиотека | Tapi32.lib |
| DLL | Tapi32.dll |