Método ITBasicCallControl::D ial (tapi3if.h)

Artigo
03/02/2024

O método Dial disca o endereço especificado.

Sintaxe

HRESULT Dial(
  [in] BSTR pDestAddress
);

Parâmetros

[in] pDestAddress

Ponteiro para a representação BSTR do endereço a ser discado. O formato deve estar em conformidade com um endereço discável padrão.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
E_POINTER	O parâmetro pDestAddress não é um ponteiro válido.
TAPI_E_TIMEOUT	A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.

Comentários

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

Em alguns casos, o aplicativo pode precisar usar as interfaces de tradução de endereço ( ITAddressTranslation e ITAddressTranslationInfo) para obter uma cadeia de caracteres pDestAddress no formato adequado.

O método Dial difere de ITAddress::CreateCall , pois a chamada já existe. Um exemplo de uso é discar uma extensão.