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 |