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

Статья
08/26/2023

Функция lineSetCallData задает элемент CallData в LINECALLINFO. В зависимости от реализации поставщика услуг член CallData может распространяться на все приложения, имеющие дескриптор вызова, в том числе на других компьютерах (через сервер), и может передаваться с вызовом при его передаче.

Синтаксис

LONG lineSetCallData(
  HCALL  hCall,
  LPVOID lpCallData,
  DWORD  dwSize
);

Параметры

hCall

Дескриптор вызова. Приложение должно иметь привилегию OWNER.

lpCallData

Адрес данных, копируемых в элемент CallData в LINECALLINFO, заменяя все существующие данные. Дополнительные сведения см. в разделе о данных вызова .

dwSize

Число байтов копируемых данных. Значение 0 приводит к удалению существующих данных.

Примечание Если lpCallData является указателем на строку, размер должен включать признак конца null.

Возвращаемое значение

Возвращает положительный идентификатор запроса, если начинается асинхронная операция; В противном случае функция возвращает одно из следующих отрицательных значений ошибки:

LINEERR_INVALCALLHANDLE, LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_NOTOWNER, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

Требования

Требование	Значение
Целевая платформа	Windows
Header	tapi.h
Библиотека	Tapi32.lib
DLL	Tapi32.dll

См. также раздел

LINECALLINFO

Функции дополнительных линейных служб

Обзор справочника по TAPI 2.2

Поделиться через