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

Статья
11/20/2024

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

Синтаксис

LONG lineGetAddressIDW(
  HLINE   hLine,
  LPDWORD lpdwAddressID,
  DWORD   dwAddressMode,
  LPCWSTR 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.

Заметка

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

Требования

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

См. также

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

Обзор TAPI 2.2

lineMakeCall

Поделиться через