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.

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

Condividi tramite