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

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.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	tapi3if.h (incluya Tapi3.h)
Library	Uuid.lib
Archivo DLL	Tapi3.dll

Consulte también

Call (objeto)

Información general de marcado

Direcciones que se pueden marcar

ITAddress::CreateCall

ITAddressTranslation

ITAddressTranslationInfo

ITBasicCallControl

lineDial