Compartir a través de


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