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


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

Функция lineGetProviderList возвращает список поставщиков услуг, установленных в системе телефонии.

Синтаксис

LONG lineGetProviderList(
  DWORD              dwAPIVersion,
  LPLINEPROVIDERLIST lpProviderList
);

Параметры

dwAPIVersion

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

lpProviderList

Указатель на расположение памяти, где TAPI может возвращать структуру LINEPROVIDERLIST . Перед вызовом lineGetProviderList приложение должно задать член dwTotalSize этой структуры, чтобы указать объем памяти, доступный ДЛЯ TAPI для возврата сведений.

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

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

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER LINEERR_STRUCTURETOOSMALL.

Требования

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

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

LINEPROVIDERLIST

Функции дополнительных линейных служб

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

lineNegotiateAPIVersion