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

  • Статья

Функция lineUnpark извлекает вызов, припаркованный по указанному адресу, и возвращает для него дескриптор вызова.

Синтаксис

LONG lineUnpark(
  HLINE   hLine,
  DWORD   dwAddressID,
  LPHCALL lphCall,
  LPCSTR  lpszDestAddress
);

Параметры

hLine

Дескриптор на устройстве с открытой линией, на котором должен быть разблокирован вызов.

dwAddressID

Адрес в hLine , с которого будет происходить распаку. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.

lphCall

Указатель на расположение типа HCALL, где возвращается дескриптор непаркованного вызова. Этот дескриптор не связан с другими дескрипторами, которые ранее могли быть связаны с извлеченным вызовом, например с дескриптором, который мог быть связан с вызовом, когда он был первоначально припаркован. Приложение является первоначальным единственным владельцем этого вызова.

lpszDestAddress

Указатель на буфер символов, завершающийся значением NULL, который содержит адрес, по которому припаркован вызов. Адрес имеет стандартный формат набираемого адреса.

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

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

LINEERR_INVALADDRESS, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED LINEERR_NOMEM.

Требования

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

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

LINE_REPLY

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

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