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

Функция lineDial вызывает указанный абонентский номер по указанному вызову.

Синтаксис

LONG lineDialW(
  HCALL   hCall,
  LPCWSTR lpszDestAddress,
  DWORD   dwCountryCode
);

Параметры

hCall

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

lpszDestAddress

Назначение для набора с помощью стандартного формата номера набора.

dwCountryCode

Код страны или региона назначения. Это используется реализацией для выбора протоколов хода выполнения вызова для целевого адреса. Если задано значение 0, используется протокол хода выполнения вызова по умолчанию, определенный поставщиком услуг.

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

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

LINEERR_ADDRESSBLOCKED, LINEERR_INVALPOINTER, LINEERR_DIALBILLING, LINEERR_NOMEM, LINEERR_DIALDIALTONE, LINEERR_NOTOWNER, LINEERR_DIALPROMPT, LINEERR_OPERATIONFAILED, LINEERR_DIALQUIET, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED, LINEERR_INVALCOUNTRYCODE.

Замечания

Если возвращается LINEERR_INVALADDRESS, телефонный номер не выполнен. Если возвращается LINEERR_DIALBILLING, LINEERR_DIALQUIET, LINEERR_DIALDIALTONE или LINEERR_DIALPROMPT, ни одно из действий, выполняемых lineDial. Например, ни один из телефонных адресов до вызова символа не был набран, состояние перехватчика не изменилось и т. д.

Функция lineDial используется для набора по существующему внешнему виду вызова. Например, после настройки звонка для передачи или конференции звонок консультации автоматически выделяется, а функция lineDial будет использоваться для вызова этого консультации. Функция lineDial может вызываться несколько раз в ходе многоэтапного набора, если возможности устройства строки позволяют ему. Кроме того, несколько адресов можно указать в одной строке набора, разделенной CRLF. Поставщики услуг, предоставляющие обратное мультиплексирование, могут устанавливать отдельные физические вызовы с каждым из адресов и возвращать один дескриптор вызова в агрегат всех вызовов приложения. Все адреса будут использовать один и тот же код страны или региона.

Абонентские номера считаются завершенными после того, как адрес передан поставщику услуг; не после завершения вызова. Поставщики услуг, предоставляющие обратное мультиплексирование, могут одновременно предоставлять несколько адресов. Поставщик услуг отправляет LINE_CALLSTATE сообщения приложению, чтобы сообщить о ходе вызова. Чтобы прервать попытку вызова во время установки вызова, вызывающее приложение должно использовать lineDrop.

Приложение может задать параметр lpszDestAddress функции lineDial адрес пустой строки, чтобы указать, что набор завершен, но только если предыдущие вызовы lineMakeCall и lineDial функции имели строки, указанные lpszDestAddress с запятой.

Функция lineDial также может использоваться в частичном наборе. Чтобы инициировать вызов с помощью частичного набора, приложение вызывает lineMakeCall и задает частичную строку набора. Частичная строка набора является любой строкой набора, завершаемой точкой с запятой. Обычно вызов переходит на LINECALLSTATE_DIALING, после чего можно вызвать lineDial, чтобы указать больше строк набора, каждый из которых завершается точкой с запятой. Вызов lineDial с строкой набора, которая не завершается точкой с запятой (например, пустой строкой). Этот метод позволяет приложениям выполнять интерактивный частичный набор с пользователем или включать более сложный набор, чем TSP, может быть способен.

Если строка назначения null или пустая строка завершается точкой с запятой (";") вводится в lineMakeCall приложение переходит к LINE_CALLSTATE_DIALTONE. Функцию lineDial можно вызвать в этом состоянии, чтобы ввести одну строку набора или несколько частичных строк набора, разделенных точкой с запятой. Приложение переходит в состояние LINECALLSTATE_DIALING после ввода первой цифры.

Примечание Функция строкового доступна только в том случае, если вызов находится в LINECALLSTATE_DIALING или LINE_CALLSTATE_DIALTONE. Если DTMF требуется во время подключения вызова (LINECALLSTATE_CONNECTED), используйте lineGenerateDigits.

 

Заметка

Заголовок tapi.h определяет lineDial как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

Справочник по службам базовой телефонии

Обзор набора

телефонные адреса

LINE_CALLSTATE

LINE_REPLY

Обзор TAPI 2.2

lineDrop

lineMakeCall