Estrutura LINECARDENTRY (tapi.h)

A estrutura LINECARDENTRY descreve um cartão de chamada. A estrutura LINETRANSLATECAPS pode conter uma matriz de estruturas LINECARDENTRY .

Sintaxe

typedef struct linecardentry_tag {
  DWORD dwPermanentCardID;
  DWORD dwCardNameSize;
  DWORD dwCardNameOffset;
  DWORD dwCardNumberDigits;
  DWORD dwSameAreaRuleSize;
  DWORD dwSameAreaRuleOffset;
  DWORD dwLongDistanceRuleSize;
  DWORD dwLongDistanceRuleOffset;
  DWORD dwInternationalRuleSize;
  DWORD dwInternationalRuleOffset;
  DWORD dwOptions;
} LINECARDENTRY, *LPLINECARDENTRY;

Membros

dwPermanentCardID

Identificador permanente que identifica o cartão.

dwCardNameSize

Tamanho da cadeia de caracteres de nome cartão incluindo terminador nulo, em bytes.

dwCardNameOffset

Deslocamento do início da estrutura para uma cadeia de caracteres terminada em nulo que descreve o cartão de maneira amigável. O tamanho do campo é especificado por dwCardNameSize.

dwCardNumberDigits

Número de dígitos no número de cartão existente. O número de cartão em si não é retornado por motivos de segurança (ele é armazenado em forma mexida pelo TAPI). O aplicativo pode usar isso para inserir bytes de preenchimento em um controle de texto no modo "senha" para mostrar que existe um número.

dwSameAreaRuleSize

Tamanho da regra de discagem da mesma área, incluindo o terminador nulo , em bytes.

dwSameAreaRuleOffset

Deslocamento do início da estrutura LINETRANSLATECAPS para a regra de discagem definida para chamadas para números no mesmo código de área. A regra é uma cadeia de caracteres terminada em nulo. O tamanho do campo é especificado por dwSameAreaRuleSize.

dwLongDistanceRuleSize

Tamanho da regra de discagem de longa distância, incluindo o terminador nulo , em bytes.

dwLongDistanceRuleOffset

Deslocamento do início da estrutura para a regra de discagem definida para chamadas a números nas outras áreas do mesmo país/região. A regra é uma cadeia de caracteres terminada em nulo. O tamanho do campo é especificado por dwLongDistanceRuleSize.

dwInternationalRuleSize

Tamanho da regra de discagem internacional, incluindo o terminador nulo , em bytes.

dwInternationalRuleOffset

Deslocamento do início da estrutura para a regra de discagem definida para chamadas a números em outros países/regiões. A regra é uma cadeia de caracteres terminada em nulo. O tamanho do campo é especificado por dwInternationalRuleSize.

dwOptions

Indica outras configurações associadas a esse cartão de chamada, usando as Constantes LINECARDOPTION_.

Comentários

Aplicativos mais antigos são compilados sem conhecimento desses novos campos e usam um SIZEOF(LINECARDENTRY) menor que o novo tamanho. Como essa é uma matriz na parte variável de uma estrutura LINETRANSLATECAPS , é imperativo que os aplicativos mais antigos recebam estruturas LINECARDENTRY no formato esperado anteriormente ou não possam indexar corretamente por meio da matriz. O aplicativo passa um parâmetro dwAPIVersion com a função lineGetTranslateCaps , que pode ser usada para diretrizes do TAPI para lidar com essa situação. A função lineGetTranslateCaps deve usar os campos LINECARDENTRY e o tamanho que correspondem à versão de API indicada, ao criar a estrutura LINETRANSLATECAPS a ser retornada ao aplicativo.

Essa estrutura pode não ser estendida.

Requisitos

Requisito	Valor
Cabeçalho	tapi.h

Confira também

LINETRANSLATECAPS

Linegettranslatecaps