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

Статья
03/02/2024

Функция lineCompleteCall указывает, как должен быть завершен вызов, который не может быть подключен обычным образом. Сеть или коммутатор могут не завершить вызов, так как сетевые ресурсы заняты, удаленная станция занята или не отвечает. Приложение может запросить выполнение вызова одним из нескольких способов.

Синтаксис

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

Параметры

hCall

Дескриптор вызова, завершение которого запрашивается. Приложение должно быть владельцем вызова. Состояние вызова hCall должно быть занято или быть обратным вызовом.

lpdwCompletionID

Указатель на расположение памяти размера DWORD. Идентификатор завершения используется для идентификации отдельных выполняемых запросов на завершение. Идентификатор завершения становится недопустимым и может использоваться повторно после завершения запроса или после отмены незавершенного запроса.

dwCompletionMode

Способ завершения вызова. Этот параметр использует одну и только одну из констант LINECALLCOMPLMODE_.

dwMessageID

Сообщение, которое должно быть отправлено при завершении вызова с помощью LINECALLCOMPLMODE_MESSAGE. Этот идентификатор выбирает сообщение из небольшого числа предопределенных сообщений.

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

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

LINEERR_COMPLETIONOVERRUN, LINEERR_NOMEM, LINEERR_INVALCALLCOMPLMODE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMESSAGEID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER LINEERR_UNINITIALIZED.

Эта функция считается завершенной, если запрос был принят сетью или коммутатором; не в случае полного завершения запроса указанным способом. После завершения этой функции вызов обычно переходит в режим простоя. Когда вызываемая станция или сеть переходит в состояние, в котором вызов может быть выполнен в соответствии с запросом, приложение получает уведомление LINE_CALLSTATE сообщение с состоянием вызова, равным предложению. Запись ВЫЗОВА LINECALLINFO перечисляет причину вызова как CALLCOMPLETION, а также предоставляет идентификатор завершения. Можно иметь несколько незавершенных запросов на завершение вызова; максимальное число зависит от устройства. Идентификатор завершения также используется для ссылки на каждый отдельный запрос, поэтому запросы можно отменить, вызвав lineUncompleteCall.