Struttura LINELOCATIONENTRY (tapi.h)

Articolo
08/26/2023

La struttura LINELOCATIONENTRY descrive una posizione usata per fornire un contesto di traduzione degli indirizzi. La struttura LINETRANSLATECAPS può contenere una matrice di strutture LINELOCATIONENTRY .

Sintassi

typedef struct linelocationentry_tag {
  DWORD dwPermanentLocationID;
  DWORD dwLocationNameSize;
  DWORD dwLocationNameOffset;
  DWORD dwCountryCode;
  DWORD dwCityCodeSize;
  DWORD dwCityCodeOffset;
  DWORD dwPreferredCardID;
  DWORD dwLocalAccessCodeSize;
  DWORD dwLocalAccessCodeOffset;
  DWORD dwLongDistanceAccessCodeSize;
  DWORD dwLongDistanceAccessCodeOffset;
  DWORD dwTollPrefixListSize;
  DWORD dwTollPrefixListOffset;
  DWORD dwCountryID;
  DWORD dwOptions;
  DWORD dwCancelCallWaitingSize;
  DWORD dwCancelCallWaitingOffset;
} LINELOCATIONENTRY, *LPLINELOCATIONENTRY;

Members

dwPermanentLocationID

Permanente. Identifica la posizione.

dwLocationNameSize

Dimensioni, in caratteri, di una stringa di nome percorso con terminazione Null, incluso il carattere null-terminazione.

dwLocationNameOffset

Dimensioni di offset, specificate in dwLocationNameSize, dall'inizio della struttura LINETRANSLATECAPS (contenente questa voce) a una stringa con terminazione null che descrive la posizione in modo descrittivo.

dwCountryCode

Codice paese o area geografica della posizione.

dwCityCodeSize

Dimensioni, in caratteri, della stringa di codice città con terminazione null, incluso il carattere null-terminazione.

dwCityCodeOffset

Offset, specificato in dwCityCodeSize, dall'inizio di questa struttura a una stringa con terminazione null specificando il codice città/area associato alla posizione. Queste informazioni, con il codice paese o dell'area geografica, possono essere usate dalle applicazioni ai campi di immissione "predefiniti" per l'utente durante l'immissione dei numeri di telefono, per incoraggiare la voce di numeri canonici appropriati.

dwPreferredCardID

Carta di chiamata preferita quando si chiama da questa posizione.

dwLocalAccessCodeSize

Dimensioni, in byte, della stringa di codice di accesso locale, incluso il terminatore Null .

dwLocalAccessCodeOffset

Dimensioni di offset, specificate in dwLocalAccessCodeSize, dall'inizio della struttura LINETRANSLATECAPS a una stringa con terminazione null contenente il codice di accesso da comporre prima delle chiamate agli indirizzi nell'area chiamante locale.

dwLongDistanceAccessCodeSize

Dimensioni, in byte, del codice di accesso a distanza prolungata, incluso il terminatore Null .

dwLongDistanceAccessCodeOffset

Dimensioni di offset, specificate in dwLongDistanceAccessCodeSize, dall'inizio della struttura LINETRANSLATECAPS a una stringa con terminazione null contenente il codice di accesso da comporre prima delle chiamate agli indirizzi esterni all'area di chiamata locale.

dwTollPrefixListSize

Dimensioni, in byte, del prefisso del pedaggio, incluso il terminatore Null .

dwTollPrefixListOffset

Dimensioni di offset, specificate in dwTollPrefixListSize, dall'inizio della struttura LINETRANSLATECAPS a una stringa con terminazione null contenente l'elenco di prefisso di pedaggio per la posizione. La stringa contiene solo prefissi costituiti dalle cifre "0" fino a "9", separate tra loro da un singolo carattere ","(virgola).

dwCountryID

Identificatore del paese/area geografica selezionato per la posizione. Questa operazione può essere usata con la funzione lineGetCountry per ottenere informazioni aggiuntive relative al paese o all'area geografica specifica, ad esempio il nome paese/area geografica (il membro dwCountryCode non può essere usato per questo scopo perché i codici paese/area geografica non sono univoci).

dwOptions

Opzioni in effetti per questa posizione, con valori presi dalle costanti LINELOCATIONOPTION_.

dwCancelCallWaitingSize

Dimensioni, in byte, della stringa cancel-call-waiting.

dwCancelCallWaitingOffset

Dimensioni di offset, specificate in dwCancelCallWaitingSize, dall'inizio della struttura LINETRANSLATECAPS a una stringa con terminazione null contenente le cifre di composizione e i caratteri del modificatore che devono essere preceduti dalla stringa dialable (dopo il carattere pulse/tono) quando un'applicazione imposta il LINETRANSLATEOPTION_CANCELCALLWAITING bit nel parametro dwTranslateOptions di lineTranslateAddress. Se non viene definito alcun prefisso, dwCancelCallWaitingSize può essere impostato su zero o 1 e dwCancelCallWaitingOffset può puntare a una stringa vuota (singolo byte NULL ).

Commenti

Questa struttura non può essere estesa.

Le applicazioni meno recenti vengono compilate senza conoscenza di questi nuovi campi e l'uso di una dimensione SIZEOF LINELOCATIONENTRY più piccola della nuova dimensione. Poiché si tratta di una matrice nella parte variabile di una struttura LINETRANSLATECAPS , è imperativo che le applicazioni precedenti ricevano strutture LINELOCATIONENTRY nel formato previsto in precedenza oppure non siano in grado di indicizzare correttamente 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 membri LINELOCATIONENTRY e le dimensioni corrispondenti alla versione API indicata, quando si compila la struttura LINETRANSLATECAPS da restituire all'applicazione.