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 |