Estructura LINECARDENTRY (tapi.h)

La estructura LINECARDENTRY describe una tarjeta de llamada. La estructura LINETRANSLATECAPS puede contener una matriz de estructuras LINECARDENTRY .

Sintaxis

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;

Miembros

dwPermanentCardID

Identificador permanente que identifica la tarjeta.

dwCardNameSize

Tamaño de la cadena de nombre de tarjeta, incluido terminador nulo , en bytes.

dwCardNameOffset

Desfase desde el principio de la estructura a una cadena terminada en null que describe la tarjeta de forma fácil de usar. DwCardNameSize especifica el tamaño del campo.

dwCardNumberDigits

Número de dígitos en el número de tarjeta existente. El número de tarjeta en sí no se devuelve por motivos de seguridad (se almacena en formato revuelto por TAPI). La aplicación puede usarlo para insertar bytes de relleno en un control de texto en modo "contraseña" para mostrar que existe un número.

dwSameAreaRuleSize

Tamaño de la misma regla de marcado de área, incluido el terminador nulo , en bytes.

dwSameAreaRuleOffset

Desfase desde el principio de la estructura LINETRANSLATECAPS hasta la regla de marcado definida para las llamadas a números en el mismo código de área. La regla es una cadena terminada en null. El tamaño del campo se especifica mediante dwSameAreaRuleSize.

dwLongDistanceRuleSize

Tamaño de la regla de marcado de larga distancia, incluido el terminador nulo , en bytes.

dwLongDistanceRuleOffset

Desfase desde el principio de la estructura hasta la regla de marcado definida para las llamadas a números de las otras áreas del mismo país o región. La regla es una cadena terminada en null. El tamaño del campo se especifica mediante dwLongDistanceRuleSize.

dwInternationalRuleSize

Tamaño de la regla de marcado internacional, incluido el terminador nulo , en bytes.

dwInternationalRuleOffset

Desplazamiento desde el principio de la estructura hasta la regla de marcado definida para las llamadas a números de otros países o regiones. La regla es una cadena terminada en null. El tamaño del campo se especifica mediante dwInternationalRuleSize.

dwOptions

Indica otra configuración asociada a esta tarjeta de llamada, utilizando las constantes LINECARDOPTION_.

Comentarios

Las aplicaciones anteriores se compilan sin conocimiento de estos nuevos campos y usan sizeOF(LINECARDENTRY) más pequeño que el nuevo tamaño. Dado que se trata de una matriz en la parte variable de una estructura LINETRANSLATECAPS , es imperativo que las aplicaciones anteriores reciban estructuras LINECARDENTRY en el formato esperado anteriormente o que no puedan indexar correctamente a través de la matriz. La aplicación pasa un parámetro dwAPIVersion con la función lineGetTranslateCaps , que TAPI puede usar para obtener instrucciones para controlar esta situación. La función lineGetTranslateCaps debe usar los campos LINECARDENTRY y el tamaño que coincidan con la versión de API indicada, al compilar la estructura LINETRANSLATECAPS que se devolverá a la aplicación.

Es posible que esta estructura no se extienda.

Requisitos

Requisito	Valor
Header	tapi.h

Consulte también

LINETRANSLATECAPS

lineGetTranslateCaps