Método ITAddressTranslation::TranslateAddress (tapi3if.h)

O método TranslateAddress cria a interface de informações de tradução de endereço. O objetivo principal do método TranslateAddress é obter a cadeia de caracteres pDestAddress (endereço discável) necessária como um parâmetro para ITAddress::CreateCall. O método TranslateAddress retorna o endereço discável indiretamente, como uma das propriedades de um objeto ITAddressTranslationInfo .

Sintaxe

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

Parâmetros

[in] pAddressToTranslate

Ponteiro para BSTR que contém o endereço que requer tradução.

[in] lCard

Chamar cartão usado para tradução.

[in] lTranslateOptions

Indicador de opções de tradução, consulte LINETRANSLATEOPTION__Constants.

[out] ppTranslated

Ponteiro para a interface ITAddressTranslationInfo recém-criada.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro ppTranslated não é um ponteiro válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
E_UNEXPECTED	O método falhou por motivos desconhecidos.
E_INVALIDARG	O valor lTranslateOptions não é válido.
TAPI_E_NODRIVER	Esse endereço não tem NENHUM TSP associado a ele.
TAPI_E_REGISTRY_SETTING_CORRUPT	O registro está corrompido.
TAPI_E_OPERATIONFAILED	O método falhou com TAPI.
TAPI_E_RESOURCEUNAVAIL	O TSP não está disponível.
TAPI_E_INVALCARD	O número cartão não é válido.

Comentários

O aplicativo deve usar SysAllocString para alocar memória para pAddressToTranslate e usar SysFreeString para liberar a memória quando a variável não for mais necessária.

O método TranslateAddress é um wrapper COM para a função TAPI 2.1 LineTranslateAddress .

O TAPI chama o método AddRef na interface ITAddressTranslationInforetornada por TranslateAddress. O aplicativo deve chamar Release na interface ITAddressTranslationInfo para liberar recursos associados a ele.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	tapi3if.h (inclua Tapi3.h)
Biblioteca	Uuid.lib
DLL	Tapi3.dll

Confira também

Objeto Address

Endereços discáveis

ITAddressTranslation