LINECOUNTRYENTRY

The LINECOUNTRYENTRY structure provides the information for a single country entry. An array of one or more of these structures is returned as part of the LINECOUNTRYLIST structure, returned by the lineGetCountry function.

typedef struct linecountryentry_tag {
    DWORD  dwCountryID;
    DWORD  dwCountryCode;
    DWORD  dwNextCountryID;
    DWORD  dwCountryNameSize;
    DWORD  dwCountryNameOffset;
    DWORD  dwSameAreaRuleSize;
    DWORD  dwSameAreaRuleOffset;
    DWORD  dwLongDistanceRuleSize;
    DWORD  dwLongDistanceRuleOffset;
    DWORD  dwInternationalRuleSize;
    DWORD  dwInternationalRuleOffset;
} LINECOUNTRYENTRY, FAR *LPLINECOUNTRYENTRY; 
 

Members

dwCountryID

The country identifier of the entry. The country identifier is an internal identifier that allows multiple entries to exist in the country list with the same country code (for example, all countries in North America and the Caribbean share country code 1, but require separate entries in the list).

dwCountryCode

The actual country code of the country represented by the entry (that is, the digits that would be dialed in an international call). Only this value should ever be displayed to users (country identifiers should never be displayed, as they would be confusing).

dwNextCountryID

The country identifier of the next entry in the country list. Because country codes and identifiers are not assigned in any regular numeric sequence, the country list is a single linked list, with each entry pointing to the next. The last country in the list has a dwNextCountryID value of zero. When the LINECOUNTRYLIST structure is used to obtain the entire list, the entries in the list are in sequence as linked by their dwNextCountryID members.

dwCountryNameSize

dwCountryNameOffset

The size in bytes and the offset in bytes from the beginning of the LINECOUNTRYLIST structure of a NULL-terminated string giving the name of the country.

dwSameAreaRuleSize

dwSameAreaRuleOffset

The size in bytes and the offset in bytes from the beginning of the LINECOUNTRYLIST structure of a NULL-terminated ASCII string containing the dialing rule for direct-dialed calls to the same area code.

dwLongDistanceRuleSize

dwLongDistanceRuleOffset

The size in bytes and the offset in bytes from the beginning of the LINECOUNTRYLIST structure of a NULL-terminated ASCII string containing the dialing rule for direct-dialed calls to other areas in the same country.

dwInternationalRuleSize

dwInternationalRuleOffset

The size in bytes and the offset in bytes from the beginning of the LINECOUNTRYLIST structure of a NULL-terminated ASCII string containing the dialing rule for direct-dialed calls to other countries.

Remarks

Not extensible.

Because this structure is returned by a new function, backward compatibility is not an issue at this time.

QuickInfo

  Version: Use TAPI version 1.4 and later.
  Header: Declared in tapi.h.

See Also

LINECOUNTRYLIST, lineGetCountry