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

2025-03-05

Функция 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.