RASCTRYINFO structure

The RASCTRYINFO structure describes the direct dialing procedures for calls placed within a specified country/region. The RasGetCountryInfo function uses this structure to retrieve country/region-specific dialing information from the Windows Telephony list of country/region information.

For more information about country/region-specific dialing information, see Telephony Application Programming Interfaces (TAPI) in the Platform Software Development Kit (SDK).

Syntax

typedef struct RASCTRYINFO {
  DWORD dwSize;
  DWORD dwCountryID;
  DWORD dwNextCountryID;
  DWORD dwCountryCode;
  DWORD dwCountryNameOffset;
} RASCTRYINFO;

Members

  • dwSize
    Specifies the size, in bytes, of the RASCTRYINFO structure. Before calling RasGetCountryInfo, set dwSize to sizeof(RASCTRYINFO) to identify the version of the structure.

  • dwCountryID
    Specifies a TAPI country/region identifier. Before calling RasGetCountryInfo, set dwCountryID to identify the country/region of interest. For more information about TAPI country/region identifiers, see Telephony Application Programming Interfaces (TAPI) in the Platform SDK.

    If this member is 1, RasGetCountryInfo returns information about the first country/region in the Windows Telephony list of country/region information.

  • dwNextCountryID
    Specifies the TAPI country/region identifier of the next country/region to enumerate in the Windows Telephony list. This member is zero for the last country/region in the list.

  • dwCountryCode
    Specifies the country/region code for the country/region identified by the dwCountryID member.

  • dwCountryNameOffset
    Specifies the offset, in bytes, from the start of the structure to the start of a null-terminated string describing the country/region. The description string is either ANSI or Unicode, depending on whether you use the ANSI or Unicode version of RasGetCountryInfo.

Remarks

For more information on dialing procedures and telephony configuration, see Telephony Application Programming Interfaces (TAPI) in the Platform SDK.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ras.h

Unicode and ANSI names

RASCTRYINFOW (Unicode) and RASCTRYINFOA (ANSI)

See also

Remote Access Service (RAS) Overview

Remote Access Service Structures

RasGetCountryInfo