please dont rip this site Prev Next

RasGetCountryInfo info  Overview  Group

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



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.

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.




The address or buffer specified by lpRasCtryInfo is invalid.


The dwCountryId member of the structure pointed to by lpRasCtryInfo was not a valid value.


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.


TAPI subsystem information was corrupted.


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


file: /Techref/os/win/api/win32/func/src/f70_14.htm, 4KB, , updated: 2000/4/7 12:19, local time: 2024/6/22 15:33,

 ©2024 These pages are served without commercial sponsorship. (No popup ads, etc...).Bandwidth abuse increases hosting cost forcing sponsorship or shutdown. This server aggressively defends against automated copying for any reason including offline viewing, duplication, etc... Please respect this requirement and DO NOT RIP THIS SITE. Questions?
Please DO link to this page! Digg it! / MAKE!

<A HREF=""> RasGetCountryInfo</A>

After you find an appropriate page, you are invited to your to this massmind site! (posts will be visible only to you before review) Just type a nice message (short messages are blocked as spam) in the box and press the Post button. (HTML welcomed, but not the <A tag: Instead, use the link box to link to another page. A tutorial is available Members can login to post directly, become page editors, and be credited for their posts.

Link? Put it here: 
if you want a response, please enter your email address: 
Attn spammers: All posts are reviewed before being made visible to anyone other than the poster.
Did you find what you needed?

  PICList 2024 contributors:
o List host: MIT, Site host, Top posters @none found
- Page Editors: James Newton, David Cary, and YOU!
* Roman Black of Black Robotics donates from sales of Linistep stepper controller kits.
* Ashley Roll of Digital Nemesis donates from sales of RCL-1 RS232 to TTL converters.
* Monthly Subscribers: Gregg Rew. on-going support is MOST appreciated!
* Contributors: Richard Seriani, Sr.

Welcome to!