LINECOUNTRYENTRY  V1LBK9

The LINECOUNTRYENTRY structure provides the information for a single country entry. An array of 1 or more of these structures is returned as part of the LINECOUNTRYLISTA_AS4O structure returned by the function lineGetCountryBRM_2E.

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 ID of the entry. The country ID is an internal identifier which 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 IDs should never be displayed, as they would be confusing).

dwNextCountryID

The country ID of the next entry in the country list. Because country codes and IDs 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 0. When the LINECOUNTRYLIST structure is used to obtain the entire list, the entries in the list will be in sequence as linked by their dwNextCountryID fields.

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.

See Also

LINECOUNTRYLIST, lineGetCountry