Metodo ITBasicCallControl::D ial (tapi3if.h)

Articolo
03/05/2024

Il metodo Dial chiama l'indirizzo specificato.

Sintassi

HRESULT Dial(
  [in] BSTR pDestAddress
);

Parametri

[in] pDestAddress

Puntatore alla rappresentazione BSTR dell'indirizzo da comporre. Il formato deve essere conforme a un indirizzo dialable standard.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_POINTER	Il parametro pDestAddress non è un puntatore valido.
TAPI_E_TIMEOUT	L'operazione non è riuscita perché la DLL TAPI 3 l'ha timeout. L'intervallo di timeout è di due minuti.

Commenti

L'applicazione deve usare SysAllocString per allocare memoria per il parametro pDestAddress e usare SysFreeString per liberare la memoria quando la variabile non è più necessaria.

In alcuni casi, l'applicazione potrebbe dover usare le interfacce di traduzione degli indirizzi ( ITAddressTranslation e ITAddressTranslationInfo) per ottenere una stringa pDestAddress nel formato appropriato.

Il metodo Dial differisce da ITAddress::CreateCall in cui la chiamata esiste già. Un esempio di utilizzo consiste nel comporre un'estensione.