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

Статья
08/26/2023

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

Синтаксис

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

Параметры

hLineApp

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

dwDeviceID

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

dwAddressID

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

dwAPIVersion

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

dwExtVersion

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

lpAddressCaps

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

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

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

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

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

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