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

Статья
08/26/2023

Функция 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.