LINETRANSLATECAPS structure (tapi.h)

The LINETRANSLATECAPS structure describes the address translation capabilities. This structure can contain an array of LINELOCATIONENTRY structures and an array of LINECARDENTRY structures. The LINETRANSLATECAPS structure is returned by the lineGetTranslateCaps function.

Syntax

typedef struct linetranslatecaps_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwNumLocations;
  DWORD dwLocationListSize;
  DWORD dwLocationListOffset;
  DWORD dwCurrentLocationID;
  DWORD dwNumCards;
  DWORD dwCardListSize;
  DWORD dwCardListOffset;
  DWORD dwCurrentPreferredCardID;
} LINETRANSLATECAPS, *LPLINETRANSLATECAPS;

Members

dwTotalSize

Total size allocated to this data structure, in bytes.

dwNeededSize

Size for this data structure that is needed to hold all the returned information, in bytes.

dwUsedSize

Size of the portion of this data structure that contains useful information, in bytes.

dwNumLocations

Number of entries in the LocationList. It includes all locations defined, including zero (default).

dwLocationListSize

Size of the list of locations known to the address translation, in bytes.

dwLocationListOffset

Offset from the beginning of this structure to the list of locations known to the address translation. The list consists of a sequence of LINELOCATIONENTRY structures. The dwLocationListOffset member points to the first byte of the first structure, and the dwLocationListSize member indicates the total number of bytes in the list.

dwCurrentLocationID

Permanent identifier for the CurrentLocation entry in the [Locations] section of the registry. See the dwPermanentLocationID member of the LINELOCATIONENTRY structure.

dwNumCards

Number of entries in the CardList.

dwCardListSize

Size of the list of calling cards known to the address translation, in bytes.

dwCardListOffset

Offset from the beginning of this structure to the list of calling cards known to the address translation. It includes only non-hidden card entries and always includes card 0 (direct dial). The list consists of a sequence of LINECARDENTRY structures. The dwCardListOffset member points to the first byte of the first structure, and the dwCardListSize member indicates the total number of bytes in the list.

dwCurrentPreferredCardID

Preferred calling card for the CurrentLocation entry in the [Locations] section of the registry. See the dwPreferredCardID member of the LINELOCATIONENTRY structure.

Remarks

This structure may not be extended.

Requirements

Requirement	Value
Header	tapi.h

See also

LINECARDENTRY

LINELOCATIONENTRY

lineGetTranslateCaps