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


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

Функция lineGetTranslateCaps возвращает возможности преобразования адресов.

Синтаксис

LONG lineGetTranslateCaps(
  HLINEAPP            hLineApp,
  DWORD               dwAPIVersion,
  LPLINETRANSLATECAPS lpTranslateCaps
);

Параметры

hLineApp

Дескриптор, возвращаемый функцией lineInitializeEx . Если приложение еще не вызывало функцию lineInitializeEx , этот параметр может иметь нулевое значение.

Примечание Приложения TAPI 1.4 должны задать для этого параметра допустимый дескриптор hLineApp, возвращаемый функцией lineInitialize .
 

dwAPIVersion

Самая высокая версия TAPI, поддерживаемая приложением (необязательно значение, согласованное lineNegotiateAPIVersion на определенном устройстве линии).

lpTranslateCaps

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

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

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

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL LINEERR_NODRIVER.

Требования

   
Целевая платформа Windows
Header tapi.h
Библиотека Tapi32.lib
DLL Tapi32.dll

См. также раздел

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

LINETRANSLATECAPS

Обзор справочника по TAPI 2.2

lineInitializeEx

lineNegotiateAPIVersion