Metodo ITAddressTranslation::TranslateAddress (tapi3if.h)

Articolo
03/02/2024

Il metodo TranslateAddress crea l'interfaccia di informazioni sulla conversione degli indirizzi. L'obiettivo principale del metodo TranslateAddress è ottenere la stringa pDestAddress (indirizzo chiamabile) necessaria come parametro per ITAddress::CreateCall. Il metodo TranslateAddress restituisce indirettamente l'indirizzo chiamabile, come una delle proprietà di un oggetto ITAddressTranslationInfo .

Sintassi

HRESULT TranslateAddress(
  [in]  BSTR                     pAddressToTranslate,
  [in]  long                     lCard,
  [in]  long                     lTranslateOptions,
  [out] ITAddressTranslationInfo **ppTranslated
);

Parametri

[in] pAddressToTranslate

Puntatore a BSTR contenente l'indirizzo che richiede la conversione.

[in] lCard

Scheda chiamante utilizzata per la traduzione.

[in] lTranslateOptions

Indicatore delle opzioni di conversione, vedere LINETRANSLATEOPTION__Constants.

[out] ppTranslated

Puntatore all'interfaccia ITAddressTranslationInfo appena creata.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro ppTranslated non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_UNEXPECTED	Il metodo non è riuscito per motivi sconosciuti.
E_INVALIDARG	Il valore lTranslateOptions non è valido.
TAPI_E_NODRIVER	Questo indirizzo non ha alcun TSP associato.
TAPI_E_REGISTRY_SETTING_CORRUPT	Il Registro di sistema è danneggiato.
TAPI_E_OPERATIONFAILED	Il metodo non è riuscito con TAPI.
TAPI_E_RESOURCEUNAVAIL	TSP non è disponibile.
TAPI_E_INVALCARD	Il numero di carta non è valido.

Commenti

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

Il metodo TranslateAddress è un wrapper COM per la funzione LineTranslateAddress TAPI 2.1.

TAPI chiama il metodo AddRef nell'interfaccia ITAddressTranslationInfo restituita da TranslateAddress. L'applicazione deve chiamare Release sull'interfaccia ITAddressTranslationInfo per liberare le risorse associate.