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

Artigo
08/26/2023

O método TranslateDialog exibe uma caixa de diálogo modal do aplicativo que permite que o usuário altere o local atual de um número de telefone prestes a ser discado, ajuste a localização e chamando parâmetros cartão e veja o efeito.

Sintaxe

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

Parâmetros

[in] hwndOwner

Um identificador para uma janela à qual a caixa de diálogo deve ser anexada. Pode ser um valor NULL para indicar que qualquer janela criada durante a função não deve ter nenhuma janela de proprietário.

[in] pAddressIn

Um ponteiro para BSTR que contém um número de telefone usado para mostrar o efeito das alterações do usuário nos parâmetros de localização. O número deve estar em formato canônico. Esse ponteiro pode ser deixado NULL, caso em que a parte número de telefone da caixa de diálogo não é exibida. Se o parâmetro pAddressIn contiver um subaddress ou campo de nome ou endereços adicionais separados do primeiro endereço por caracteres ASCII CR e LF, somente o primeiro endereço será usado na caixa de diálogo.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O parâmetro hwndOwner não é um identificador válido ou o parâmetro pAddressIn não é um número de telefone válido.
E_POINTER	O parâmetro pAddressIn não é um ponteiro válido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
E_UNEXPECTED	Erro inesperado.
TAPI_E_REGISTRY_SETTING_CORRUPT	As configurações do Registro para tradução de endereço não são válidas.
TAPI_E_NODRIVER	Não existe NENHUM TSP que possa fazer a tradução para esse endereço.
TAPI_E_INUSE	A caixa de diálogo já está aberta e em uso.
TAPI_E_INVALADDRESS	O endereço atual não é válido.
TAPI_E_OPERATIONFAILED	O TAPI não pôde concluir a operação.

Comentários

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

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