Funzione lineTranslateAddress (tapi.h)

Articolo
03/05/2024

La funzione lineTranslateAddress converte l'indirizzo specificato in un altro formato.

Sintassi

LONG lineTranslateAddress(
  HLINEAPP              hLineApp,
  DWORD                 dwDeviceID,
  DWORD                 dwAPIVersion,
  LPCSTR                lpszAddressIn,
  DWORD                 dwCard,
  DWORD                 dwTranslateOptions,
  LPLINETRANSLATEOUTPUT lpTranslateOutput
);

Parametri

hLineApp

Handle restituito da lineInitializeEx. Se un'applicazione TAPI 2.x non ha ancora chiamato la funzione lineInitializeEx , può impostare questo parametro su NULL. Le applicazioni TAPI 1.4 devono comunque chiamare prima lineInitialize .

dwDeviceID

Identificatore del dispositivo di linea su cui deve essere composta la 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 in un determinato dispositivo line).

lpszAddressIn

Puntatore a una stringa con terminazione Null contenente l'indirizzo delle informazioni da estrarre per la traduzione. Deve essere nel formato di indirizzo canonico o in una stringa arbitraria di cifre digitabili (non canoniche). Questo parametro non deve essere NULL. Se AddressIn contiene un campo subaddress o nome o indirizzi aggiuntivi separati dal primo indirizzo in base ai caratteri CR e LF, viene convertito solo il primo indirizzo.

dwCard

Carta di credito da utilizzare per la composizione. Questo parametro è valido solo se il bit CARDOVERRIDE è impostato in dwTranslateOptions. Questo parametro specifica l'identificatore permanente di una voce Card nella sezione [Cards] del Registro di sistema (come ottenuto da lineTranslateCaps) che deve essere utilizzato anziché il PreferredCardID specificato nella definizione di CurrentLocation. Non determina la modifica del parametro PreferredCardID della voce Location corrente nel Registro di sistema; l'override si applica solo all'operazione di conversione corrente. Questo parametro viene ignorato se il bit CARDOVERRIDE non è impostato in dwTranslateOptions.

dwTranslateOptions

Operazioni associate da eseguire prima della conversione dell'indirizzo in una stringa componibile. Questo parametro usa una delle costanti LINETRANSLATEOPTION_.

Se è stato impostato il bit LINETRANSLATEOPTION_CANCELCALLWAITING, è anche consigliabile impostare il bit LINECALLPARAMFLAGS_SECURE nel membro dwCallParamFlags della struttura LINECALLPARAMS (passato a lineMakeCall tramite il parametro lpCallParams ). Ciò impedisce al dispositivo linea di usare cifre digitabili per eliminare gli interrupt di chiamata.

lpTranslateOutput

Puntatore a un'area di memoria allocata dall'applicazione per contenere l'output dell'operazione di conversione, di tipo LINETRANSLATEOUTPUT. Prima di chiamare lineTranslateAddress, l'applicazione deve impostare il membro dwTotalSize di questa struttura per indicare la quantità di memoria disponibile per TAPI per la restituzione di informazioni.

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_INVALPOINTER, LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NODRIVER, LINEERR_INIFILECORRUPT, LINEERR_NOMEM, LINEERR_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_INVALAPPHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCARD, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPARAM.