Metodo ITAddressTranslation::TranslateDialog (tapi3if.h)

Articolo
08/26/2023

Il metodo TranslateDialog visualizza una finestra di dialogo modale dell'applicazione che consente all'utente di modificare la posizione corrente di un numero di telefono da comporre, regolare la posizione e i parametri della carta chiamante e visualizzare l'effetto.

Sintassi

HRESULT TranslateDialog(
  [in] TAPIHWND hwndOwner,
  [in] BSTR     pAddressIn
);

Parametri

[in] hwndOwner

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

[in] pAddressIn

Puntatore a BSTR contenente un numero di telefono usato per mostrare l'effetto delle modifiche dell'utente sui parametri della posizione. Il numero deve essere in formato canonico. 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 pAddressIn contiene un campo subaddress o nome o indirizzi aggiuntivi separati dal primo indirizzo in base ai caratteri CR e LF ASCII, viene usato solo il primo indirizzo nella finestra di dialogo.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_INVALIDARG	Il parametro hwndOwner non è un handle valido o il parametro pAddressIn non è un numero di telefono valido.
E_POINTER	Il parametro pAddressIn non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_UNEXPECTED	Si è verificato un errore imprevisto.
TAPI_E_REGISTRY_SETTING_CORRUPT	Le impostazioni del Registro di sistema per la traduzione degli indirizzi non sono valide.
TAPI_E_NODRIVER	Nessun TSP esiste che può eseguire la traduzione per questo indirizzo.
TAPI_E_INUSE	La finestra di dialogo è già aperta e in uso.
TAPI_E_INVALADDRESS	L'indirizzo corrente non è valido.
TAPI_E_OPERATIONFAILED	TAPI non è stato in grado di completare l'operazione.

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per pAddressIn e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

Il metodo TranslateDialog è un wrapper COM per la funzione LINETranslateDialog TAPI 2.1.