функция TSPI_lineSetAppSpecific (tspi.h)
Функция TSPI_lineSetAppSpecific задает зависящее от приложения поле структуры LINECALLINFO указанного вызова.
Синтаксис
LONG TSPIAPI TSPI_lineSetAppSpecific(
HDRVCALL hdCall,
DWORD dwAppSpecific
);
Параметры
hdCall
Дескриптор для вызова, для которого необходимо задать поле для конкретного приложения. Состояние вызова hdCall может быть любым.
dwAppSpecific
Новое содержимое члена dwAppSpecific для структуры LINECALLINFO вызова. Это значение не интерпретируется поставщиком услуг. Этот параметр не проверяется TAPI при вызове этой функции.
Возвращаемое значение
Возвращает ноль, если функция выполнена успешно, или номер ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL LINEERR_OPERATIONUNAVAIL.
Комментарии
Поле конкретного приложения в структуре данных LINECALLINFO , которое существует для каждого вызова, не интерпретируется API телефонии или любым из его поставщиков услуг. Его использование полностью определяется приложениями. Поле можно считать из записи LINECALLINFO , возвращенной TSPI_lineGetCallInfo. Однако для задания поля необходимо использовать TSPI_lineSetAppSpecific , чтобы изменения стали видимыми для других приложений. При изменении этого поля поставщик услуг отправляет LINE_CALLINFO сообщение с указанием изменения поля AppSpecific .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |