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

Функция lineGetAddressCaps запрашивает указанный адрес на указанном устройстве строки, чтобы определить его возможности телефонии.

Синтаксис

LONG lineGetAddressCapsA(
  HLINEAPP          hLineApp,
  DWORD             dwDeviceID,
  DWORD             dwAddressID,
  DWORD             dwAPIVersion,
  DWORD             dwExtVersion,
  LPLINEADDRESSCAPS lpAddressCaps
);

Параметры

hLineApp

Обработка регистрации приложения с помощью TAPI.

dwDeviceID

Устройство строки, содержащее адрес для запроса.

dwAddressID

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

dwAPIVersion

Номер версии используемого API телефонии. Слово высокого порядка содержит основной номер версии; Слово с низким порядком содержит дополнительный номер версии. Это число получается lineNegotiateAPIVersion.

dwExtVersion

Номер версии используемых расширений поставщика услуг. Это число может быть равно нулю, если не используются расширения для конкретного устройства. В противном случае слово высокого порядка содержит основной номер версии; и слово с низким порядком содержит дополнительный номер версии.

lpAddressCaps

Указатель на изменяемую структуру типа LINEADDRESSCAPS. После успешного завершения запроса эта структура заполняется сведениями об адресных возможностях. Перед вызовом lineGetAddressCapsCapsприложение должно задать элемент dwTotalSize этой структуры, чтобы указать объем памяти, доступной TAPI для возврата сведений.

Примечание Если параметры размера в структуре неверны, существует вероятность того, что данные могут быть перезаписаны. Дополнительные сведения о настройке размеров структуры см. в разделе выделение памяти.

 

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

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

LINEERR_BADDEVICEID, LINEERR_NOMEM, LINEERR_OPERATIONFAILED LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALAPPHANDLE, LINEERR_UNINITIALIZED, LINEERR_INVALPOINTER, LINEERR_OPERATIONUNAVAIL, LINEERR_NODRIVER, LINEERR_NODEVICE.

Замечания

Допустимые идентификаторы адресов варьируются от нуля до одного меньше числа адресов, возвращаемых lineGetDevCaps. Номер версии, который необходимо указать, — это номер версии, возвращаемый в рамках возможностей устройства строки lineGetDevCaps.

Заметка

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

Требования

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

См. также

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

LINEADDRESSCAPS

Обзор TAPI 2.2

lineGetDevCaps

lineNegotiateAPIVersion