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

Artículo
03/02/2024

El método Dial marca la dirección especificada.

Sintaxis

HRESULT Dial(
  [in] BSTR pDestAddress
);

Parámetros

[in] pDestAddress

Puntero a la representación BSTR de la dirección que se va a marcar. El formato debe ajustarse a una dirección de marcado estándar.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Significado
S_OK	El método se realizó correctamente.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_POINTER	El parámetro pDestAddress no es un puntero válido.
TAPI_E_TIMEOUT	Error en la operación porque el archivo DLL tapi 3 lo agotó. El intervalo de tiempo de espera es de dos minutos.

Comentarios

La aplicación debe usar SysAllocString para asignar memoria para el parámetro pDestAddress y usar SysFreeString para liberar la memoria cuando la variable ya no sea necesaria.

En algunos casos, es posible que la aplicación tenga que usar las interfaces de traducción de direcciones ( ITAddressTranslation y ITAddressTranslationInfo) para obtener una cadena pDestAddress en el formato adecuado.

El método Dial difiere de ITAddress::CreateCall en que la llamada ya existe. Un ejemplo de uso es marcar una extensión.