Struttura LINETRANSLATEOUTPUT (tapi.h)

Articolo
03/02/2024

La struttura LINETRANSLATEOUTPUT descrive il risultato di una conversione degli indirizzi. La funzione lineTranslateAddress usa questa struttura.

Sintassi

typedef struct linetranslateoutput_tag {
  DWORD dwTotalSize;
  DWORD dwNeededSize;
  DWORD dwUsedSize;
  DWORD dwDialableStringSize;
  DWORD dwDialableStringOffset;
  DWORD dwDisplayableStringSize;
  DWORD dwDisplayableStringOffset;
  DWORD dwCurrentCountry;
  DWORD dwDestCountry;
  DWORD dwTranslateResults;
} LINETRANSLATEOUTPUT, *LPLINETRANSLATEOUTPUT;

Members

dwTotalSize

Dimensioni totali allocate a questa struttura di dati, in byte.

dwNeededSize

Dimensioni necessarie per questa struttura di dati per contenere tutte le informazioni restituite, in byte.

dwUsedSize

Dimensioni della parte di questa struttura di dati che contiene informazioni utili, in byte.

dwDialableStringSize

Dimensione stringa chiamabile, in byte, incluso il valore NULL di terminazione.

dwDialableStringOffset

Offset dall'inizio di questa struttura all'output tradotto che può essere passato alla funzione lineMakeCall, lineDial o ad altra funzione che richiede una stringa componibile. L'output è sempre una stringa con terminazione Null. I campi ausiliari, ad esempio nome e subaddress, sono inclusi in questa stringa di output se si trovano nella stringa di input. Questa stringa può contenere informazioni private, ad esempio numeri di carta di chiamata. Non deve essere visualizzato all'utente, per impedire la visibilità accidentale a persone non autorizzate. Le dimensioni del campo sono specificate da dwDialableStringSize.

dwDisplayableStringSize

Dimensione dell'output tradotto che può essere visualizzato all'utente, incluso il carattere di terminazione Null , in byte.

dwDisplayableStringOffset

Offset all'output tradotto che può essere visualizzato all'utente per la conferma. È identico a DialableString, eccetto le cifre della carta chiamante vengono sostituite con il nome descrittivo della scheda racchiusa tra parentesi quadre (ad esempio, "[AT&T Card]") e vengono rimossi campi ausiliari come nome e subaddress. Usare un messaggio appropriato in dwDisplayableStringOffset, perché la stringa potrebbe essere visualizzata pubblicamente nella finestra di dialogo stato chiamata. Queste informazioni sono appropriate anche per includere nei log delle chiamate. Le dimensioni del campo sono specificate da dwDisplayableStringSize.

dwCurrentCountry

Codice paese o area geografica configurato in CurrentLocation. Questo valore può essere usato per controllare la visualizzazione da parte dell'applicazione di determinati elementi dell'interfaccia utente, per il rilevamento del tono di avanzamento della chiamata locale e per altri scopi.

dwDestCountry

Codice paese/area geografica di destinazione dell'indirizzo tradotto. Questo valore può essere passato al parametro dwCountryCode di lineMakeCall e ad altre funzioni di composizione (in modo che vengano rilevati correttamente i toni di avanzamento delle chiamate del paese/area geografica di destinazione, ad esempio un segnale occupato). Questo campo è impostato su zero se l'indirizzo di destinazione passato a lineTranslateAddress non è in formato canonico.

dwTranslateResults

Informazioni derivate dal processo di traduzione, che possono aiutare l'applicazione a presentare elementi dell'interfaccia utente. Questo campo usa una delle costanti LINETRANSLATERESULT_.