ITBasicCallControl ::D ial, méthode (tapi3if.h)

Article
03/02/2024

La méthode Dial compose l’adresse spécifiée.

Syntaxe

HRESULT Dial(
  [in] BSTR pDestAddress
);

Paramètres

[in] pDestAddress

Pointeur vers la représentation BSTR de l’adresse à composer. Le format doit être conforme à une adresse de numérotation standard.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur	Signification
S_OK	La méthode a réussi.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
E_POINTER	Le paramètre pDestAddress n’est pas un pointeur valide.
TAPI_E_TIMEOUT	L’opération a échoué, car la DLL TAPI 3 l’a expiré. L’intervalle de délai d’expiration est de deux minutes.

Remarques

L’application doit utiliser SysAllocString pour allouer de la mémoire pour le paramètre pDestAddress et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

Dans certains cas, l’application peut avoir besoin d’utiliser les interfaces de traduction d’adresses ( ITAddressTranslation et ITAddressTranslationInfo) pour obtenir une chaîne pDestAddress au format approprié.

La méthode Dial diffère de ITAddress ::CreateCall en ce que l’appel existe déjà. Un exemple d’utilisation est la numérotation d’une extension.