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

Статья
08/26/2023

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

Синтаксис

LONG lineGetAddressID(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCSTR  lpsAddress,
  DWORD   dwSize
);

Параметры

hLine

Дескриптор на устройстве с открытой линией.

lpdwAddressID

Указатель на расположение памяти размера DWORD, где возвращается идентификатор адреса. Идентификатор адреса постоянно связан с адресом; идентификатор остается неизменным при обновлении операционной системы.

dwAddressMode

Режим адреса, содержащегося в lpsAddress. Этот параметр использует только одну из констант LINEADDRESSMODE_. Необходимо указать LINEADDRESSMODE_DIALABLEADDR.

lpsAddress

Указатель на структуру данных, содержащую адрес, назначенный указанному устройству линии. Формат адреса определяется dwAddressMode. Так как единственное допустимое значение — LINEADDRESSMODE_DIALABLEADDR, lpsAddress использует общий формат номера с возможностью набора и завершается со значением NULL.

dwSize

Размер (в байтах) адреса, содержащегося в lpsAddress. Размер строки должен включать признак конца null.

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

Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:

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

Функция lineGetAddressID используется для сопоставления номера телефона (адреса), назначенного линейному устройству, с его dwAddressID в нулевом диапазоне с количеством адресов минус один, возвращенный в возможностях устройства линии. Функция lineMakeCall позволяет приложению выполнять вызов, указывая дескриптор строки и адрес в строке. Адрес можно указать как dwAddressID, как номер телефона или как имя или идентификатор устройства. Использование номера телефона может быть целесообразно в средах, где одной строке назначается несколько адресов.

Примечание LINEADDRESSMODE_ADDRESSID не может использоваться с lineGetAddressID.