Функция RasGetCountryInfoA (ras.h)

Статья
08/25/2023

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

Дополнительные сведения о наборе номера для конкретной страны или региона и идентификаторах страны и региона интерфейса TAPI см. в части TAPI пакета sdk для разработки программного обеспечения для платформы.

Синтаксис

DWORD RasGetCountryInfoA(
  [in, out] LPRASCTRYINFOA unnamedParam1,
  [in, out] LPDWORD        unnamedParam2
);

Параметры

[in, out] unnamedParam1

Указатель на структуру RASCTRYINFO , которая в выходных данных получает сведения о наборе номера для конкретной страны или региона, за которым следуют дополнительные байты для строки описания страны или региона.

На входных данных задайте для элемента dwSize структуры значение sizeof(RASCTRYINFO), чтобы определить версию структуры. Кроме того, присвойте члену dwCountryId идентификатор страны или региона TAPI страны или региона, для которого требуется получить сведения.

Выделите не менее 256 байт для буфера.

[in, out] unnamedParam2

Указатель на переменную, которая во входных данных указывает размер буфера в байтах, на который указывает параметр lpRasCtryInfo .

В выходных данных эта переменная получает необходимое количество байтов.

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

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается ошибкой, возвращается один из следующих кодов ошибок или значение из кода ошибок маршрутизации и удаленного доступа или Winerror.h.

Значение	Значение
ERROR_INVALID_USER_BUFFER	Недопустимый адрес или буфер, указанный lpRasCtryInfo .
ERROR_INVALID_PARAMETER	Член dwCountryId структуры, на который указывает lpRasCtryInfo , не является допустимым значением.
ERROR_BUFFER_TOO_SMALL	Размер буфера lpRasCtryInfo , указанный параметром lpdwSize , не был достаточно велик для хранения сведений о стране или регионе, определенных членом dwCountryId . Функция возвращает требуемый размер буфера в переменной, на которую указывает lpdwSize.
ERROR_TAPI_CONFIGURATION	Повреждены сведения о подсистеме TAPI.

Чтобы перечислить сведения для всех стран или регионов в списке телефонии Windows, присвойте члену dwCountryId структуры RASCTRYINFO значение 1 в первоначальном вызове RasGetCountryInfo . Это приводит к тому, что функция возвращает сведения о первой стране или регионе в списке. Значение, возвращаемое в члене dwNextCountryID , является идентификатором страны или региона следующей страны или региона в списке. Используйте это значение при повторных вызовах RasGetCountryInfo , пока dwNextCountryID не вернет ноль, указывая последнюю страну или регион в списке.

Примечание

Заголовок ras.h определяет RasGetCountryInfo в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ras.h
Библиотека	Rasapi32.lib
DLL	Rasapi32.dll

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

RASCTRYINFO

Обзор службы удаленного доступа (RAS)

Функции службы удаленного доступа