dwPermanentLocationID

Permanent identifier that identifies the location.

dwLocationNameSize

Contains a null-terminated ASCII string (size includes the NULL) that describes the location in a user-friendly manner.

dwLocationNameOffset

Contains a null-terminated ASCII string (size includes the NULL) that describes the location in a user-friendly manner.

dwCountryCode

Country/region code of the location.

dwPreferredCardID

Preferred calling card when dialing from this location.

dwCityCodeSize

Contains a null-terminated ASCII string specifying the city/area code associated with the location (the size includes the NULL). This data, along with the country/region code, can be used by applications to default entry fields for the user when entering phone numbers, to encourage the entry of proper canonical numbers.

dwCityCodeOffset

Contains a null-terminated ASCII string specifying the city/area code associated with the location (the size includes the NULL). This data, along with the country/region code, can be used by applications to default entry fields for the user when entering phone numbers, to encourage the entry of proper canonical numbers.

dwLocalAccessCodeSize

Size, in bytes, of a null-terminated ASCII string containing the access code to be dialed before calls to addresses in the local calling area.

dwLocalAccessCodeOffset

Offset in bytes from the beginning of the LINETRANSLATECAPSstructure.

dwLongDistanceAccessCodeSize

Size, in bytes, of a null-terminated ASCII string containing the access code to be dialed before calls to addresses outside the local calling area.

dwLongDistanceAccessCodeOffset

Offset in bytes from the beginning of the LINETRANSLATECAPSstructure.

dwTollPrefixListSize

Size, in bytes, of a null-terminated ASCII string containing the toll prefix list for the location. The string contains only prefixes consisting of the digits 0 through 9, separated from each other by a single comma (,) character.

dwTollPrefixListOffset

Offset in bytes from the beginning of the LINETRANSLATECAPSstructure.

dwCountryID

Country/region identifier of the country/region selected for the location.

dwOptions

Value that indicates options in effect for this location, with values taken from the LINELOCATIONOPTION.

dwCancelCallWaitingSize

Size, in bytes, of a null-terminated ASCII string containing the dial digits and modifier characters that should be prefixed to the dialable string (after the pulse/tone character) when an application sets the LINETRANSLATEOPTION_CANCELCALLWAITING bit in the dwTranslateOptionsparameter of the lineTranslateAddressfunction. If no prefix is defined, this can be indicated by dwCancelCallWaitingSizebeing set to zero, or by it being set to 1 and dwCancelCallWaitingOffsetpointing to an empty string (single NULL byte).

dwCancelCallWaitingOffset

Offset, in bytes, from the beginning of the LINETRANSLATECAPSstructure.

No extensions.

Older applications are compiled without knowledge of these new fields, and using a SIZEOF LINELOCATIONENTRYsmaller than the new size. Because this is an array in the variable portion of a LINETRANSLATECAPSstructure, it is imperative that older applications receive LINELOCATIONENTRYstructures in the format they previously expected, or they are not able to index through the array properly. The application passes in a dwAPIVersionparameter with the lineGetTranslateCapsfunction, which can be used for guidance by TAPI in handling this situation. The lineGetTranslateCapsfunction should use the LINELOCATIONENTRYmembers and size that match the indicated API version, when building the LINETRANSLATECAPSstructure to be returned to the application.