Metodo ITAddressTranslation::TranslateAddress (tapi3if.h)

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.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione tapi3if.h (include Tapi3.h)
Libreria Uuid.lib
DLL Tapi3.dll

Vedi anche

Oggetto Address

Indirizzi componibili

ITAddressTranslation