Funzione lineTranslateDialog (tapi.h)

Articolo
03/08/2023

La funzione lineTranslateDialog visualizza una finestra di dialogo modale dell'applicazione che consente all'utente di modificare la posizione corrente di un numero di telefono che sta per essere composto, regolare i parametri della posizione e della scheda chiamante e visualizzare l'effetto.

Sintassi

LONG lineTranslateDialog(
  HLINEAPP hLineApp,
  DWORD    dwDeviceID,
  DWORD    dwAPIVersion,
  HWND     hwndOwner,
  LPCSTR   lpszAddressIn
);

Parametri

hLineApp

Handle dell'applicazione restituito da lineInitializeEx. Se un'applicazione non ha ancora chiamato la funzione lineInitializeEx , può impostare il parametro hLineApp su zero.

dwDeviceID

Identificatore del dispositivo per il dispositivo di linea su cui deve essere chiamata, in modo che le variazioni nelle procedure di composizione su righe diverse possano essere applicate al processo di traduzione.

dwAPIVersion

Versione più recente di TAPI supportata dall'applicazione (non necessariamente il valore negoziato da lineNegotiateAPIVersion nel dispositivo linea indicato da dwDeviceID).

hwndOwner

Handle in una finestra a cui deve essere collegata la finestra di dialogo. Può essere un valore NULL per indicare che qualsiasi finestra creata durante la funzione non deve avere una finestra di proprietario.

lpszAddressIn

Puntatore a una stringa con terminazione Null contenente un numero di telefono utilizzato, nella parte inferiore della finestra di dialogo, per visualizzare l'effetto delle modifiche dell'utente sui parametri di posizione. Il numero deve essere in formato canonico; se noncanonical, la parte relativa al numero di telefono della finestra di dialogo non viene visualizzata. Questo puntatore può essere lasciato NULL, nel qual caso la parte del numero di telefono della finestra di dialogo non viene visualizzata. Se il parametro lpszAddressIn contiene un campo subaddress o name o indirizzi aggiuntivi separati dal primo indirizzo in base ai caratteri CR e LF, nella finestra di dialogo viene utilizzato solo il primo indirizzo.

Valore restituito

Restituisce zero se la richiesta ha esito positivo o negativo se si verifica un errore. I valori restituiti possibili sono:

LINEERR_BADDEVICEID, LINEERR_INVALPARAM, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_INVALPOINTER, LINEERR_INIFILECORRUPT, LINEERR_NODRIVER, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_INVALAPPHANDLE LINEERR_OPERATIONFAILED.

Commenti

In TAPI versione 2.0 o successiva è possibile aprire più istanze di questa finestra di dialogo. Nelle versioni TAPI precedenti alla 2.0, LINEERR_INUSE viene restituito se la finestra di dialogo è già visualizzata da un'altra applicazione (non può essere aperta più volte). In queste versioni, TAPI porta la finestra di dialogo esistente sul lato anteriore e l'errore indica che eventuali particolari correlati all'indirizzo passato dall'applicazione corrente non sono stati gestiti, perché tale indirizzo non è stato elaborato dalla funzione.

L'applicazione deve chiamare lineGetTranslateCaps dopo questa funzione per ottenere le modifiche apportate dall'utente ai parametri di conversione degli indirizzi di telefonia e chiamare lineTranslateAddress per ottenere una stringa chiamabile in base alle nuove selezioni dell'utente.

Se una funzione correlata alla conversione degli indirizzi,ad esempio lineGetTranslateCaps o lineTranslateAddress, restituisce LINEERR_INIFILECORRUPT, l'applicazione deve chiamare lineTranslateDialog. La funzione lineTranslateDialog rileva gli errori e li corregge e segnala l'azione eseguita all'utente.