На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

RasGetCountryInfo



[New - Windows NT]

The RasGetCountryInfo function retrieves country-specific dialing information from the Windows Telephony list of countries.
For more information about country-specific dialing information and TAPI country identifiers, see the Win32 Telephony (TAPI) Programmer's Reference.

DWORD RasGetCountryInfo(

LPRASCTRYINFO lpRasCtryInfo, // buffer that receives country information
LPDWORD lpdwSize // size, in bytes, of the buffer
);


Parameters

lpRasCtryInfo

Pointer to a RASCTRYINFO structure that receives the country-specific dialing information followed by additional bytes for a country description string. Before calling the function, set the dwSize member of the structure to sizeof(RASCTRYINFO) to identify the version of the structure. You must also set the dwCountryId member to the TAPI country identifier of the country for which to get information.
The size of the buffer should be at least 256 bytes.

lpdwSize

Pointer to a variable that contains the size, in bytes, of the buffer pointed to by the lpRasCtryInfo parameter. On return, the function sets this variable to the number of bytes required.



Return Values

If the function succeeds, the return value is zero.
If the function fails, the return value can be one of the following error codes.

Value Meaning
ERROR_INVALID_USER_BUFFER The address or buffer specified by lpRasCtryInfo is invalid.
ERROR_INVALID_PARAMETER The dwCountryId member of the structure pointed to by lpRasCtryInfo was not a valid value.
ERROR_BUFFER_TOO_SMALL The size of the lpRasCtryInfo buffer specified by the lpdwSize parameter was not large enough to store the information for the country identified by the dwCountryId member. The function returns the required buffer size in the variable pointed to by lpdwSize.
ERROR_TAPI_CONFIGURATION TAPI subsystem information was corrupted.


Remarks

To enumerate information for all countries in the Windows Telephony list, set the dwCountryId member of the RASCTRYINFO structure to 1 in the initial RasGetCountryInfo call. This causes the function to return information for the first country in the list. The value returned in the dwNextCountryId member is the country identifier of the next country in the list. Use this value in repeated calls to RasGetCountryInfo until dwNextCountryID returns zero, indicating the last country in the list.

See Also

RASCTRYINFO


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

RasGetCountryInfo



[Новый - Windows NT]

Функция RasGetCountryInfo извлекает страна-специфическую информацию кодового вызова из списка ТелефоннаяNсвязи Windows стран.
Более подробно о страна-специфической информации кодового вызова и идентификаторов страны TAPI, смотри ТелефоннаяNсвязь Win32 (TAPI) Ссылку Программиста.

DWORD RasGetCountryInfo(

LPRASCTRYINFO lpRasCtryInfo, // БУФЕР, который получает информацию страны LPDWORD lpdwSize // размер, в байтах, буфера
);


Параметры

lpRasCtryInfo

Указатель в структуру RASCTRYINFO, которая получает страна-специфическую информацию кодового вызова сопровождался дополнительными байтами для строки описания страны. Перед вызовом функции, установите элемент dwSize структуры, чтобы sizeof(RASCTRYINFO), чтобы идентифицировать версию структуры. Вы должны также установить элемент dwCountryId в идентификатор страны TAPI страны для которого, чтобы получать информацию.
Размер буфера должен быть по крайней мере 256 байтов.

lpdwSize

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



Обратные Величины

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

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


Замечания

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

Смотри Также

RASCTRYINFO


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz