Struttura LINECARDENTRY (tapi.h)

La struttura LINECARDENTRY descrive una carta chiamante. La struttura LINETRANSLATECAPS può contenere una matrice di strutture LINECARDENTRY .

Sintassi

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;

Members

dwPermanentCardID

Identificatore permanente che identifica la scheda.

dwCardNameSize

Dimensioni della stringa del nome della scheda, tra cui terminazione Null , in byte.

dwCardNameOffset

Offset dall'inizio della struttura a una stringa con terminazione null che descrive la scheda in modo descrittivo. Le dimensioni del campo sono specificate da dwCardNameSize.

dwCardNumberDigits

Numero di cifre nel numero di carta esistente. Il numero di carta stesso non viene restituito per motivi di sicurezza (viene archiviato in formato scrambled by TAPI). L'applicazione può usare questa opzione per inserire byte di riempimento in un controllo di testo in modalità "password" per mostrare che esiste un numero.

dwSameAreaRuleSize

Dimensioni della regola di composizione della stessa area, inclusa la terminazione Null , in byte.

dwSameAreaRuleOffset

Offset dall'inizio della struttura LINETRANSLATECAPS alla regola di composizione definita per le chiamate ai numeri nello stesso codice di area. La regola è una stringa con terminazione null. Le dimensioni del campo vengono specificate da dwSameAreaRuleSize.

dwLongDistanceRuleSize

Dimensioni della regola di composizione a distanza lunga, tra cui il terminatore Null , in byte.

dwLongDistanceRuleOffset

Offset dall'inizio della struttura alla regola di composizione definita per le chiamate ai numeri nelle altre aree dello stesso paese/area geografica. La regola è una stringa con terminazione null. Le dimensioni del campo sono specificate da dwLongDistanceRuleSize.

dwInternationalRuleSize

Dimensioni della regola di composizione internazionale, tra cui il terminatore Null , in byte.

dwInternationalRuleOffset

Offset dall'inizio della struttura alla regola di composizione definita per le chiamate a numeri in altri paesi/aree geografiche. La regola è una stringa con terminazione null. Le dimensioni del campo sono specificate da dwInternationalRuleSize.

dwOptions

Indica altre impostazioni associate a questa scheda chiamante usando le costanti LINECARDOPTION_.

Commenti

Le applicazioni meno recenti vengono compilate senza conoscenza di questi nuovi campi e l'uso di una dimensione SIZEOF(LINECARDENTRY) inferiore alla nuova dimensione. Poiché si tratta di una matrice nella parte variabile di una struttura LINETRANSLATECAPS , è imperativo che le applicazioni meno recenti ricevano strutture LINECARDENTRY nel formato previsto in precedenza o non siano in grado di indicizzare correttamente tramite la matrice. L'applicazione passa un parametro dwAPIVersion con la funzione lineGetTranslateCaps , che può essere usata per indicazioni da TAPI nella gestione di questa situazione. La funzione lineGetTranslateCaps deve usare i campi LINECARDENTRY e le dimensioni corrispondenti alla versione dell'API indicata, quando si compila la struttura LINETRANSLATECAPS da restituire all'applicazione.

Questa struttura potrebbe non essere estesa.

Requisiti

Vedi anche

LINETRANSLATECAPS

lineGetTranslateCaps