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

Статья
03/02/2024

Функция lineGetCountry извлекает хранимые правила набора номера и другую информацию, связанную с указанной страной или регионом, первой страной или регионом в списке стран или регионов или всеми странами или регионами.

Синтаксис

LONG lineGetCountry(
  DWORD             dwCountryID,
  DWORD             dwAPIVersion,
  LPLINECOUNTRYLIST lpLineCountryList
);

Параметры

dwCountryID

Идентификатор страны или региона (не код страны) страны или региона, для которого требуется получить информацию. Если указано значение 1, получается информация о первой стране или регионе в списке стран или регионов. Если указано значение 0, получается информация обо всех странах и регионах (что может потребовать большого объема памяти — 20 КБ или более).

dwAPIVersion

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

lpLineCountryList

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

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

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

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

LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INIFILECORRUPT, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_STRUCTURETOOSMALL LINEERR_INVALPOINTER.