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

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

Синтаксис

LONG lineGetTranslateCapsW(
  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.

Замечания

Заметка

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

Требования

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

См. также

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

LINETRANSLATECAPS

Обзор TAPI 2.2

lineInitializeEx

lineNegotiateAPIVersion