MÉTHODE ITAddress ::CreateCall (tapi3if.h)

Article
03/02/2024

La méthode CreateCall crée un objet Call qui peut être utilisé pour effectuer un appel sortant et retourne un pointeur vers l’interface ITBasicCallControl de l’objet. L’appel nouvellement créé est dans l’état CS_IDLE et n’a pas de support ou de terminal sélectionné.

Les valeurs d’entrée acceptables pour l’adresse d’appel, le type d’adresse et les types de média sont spécifiques au fournisseur de services de téléphonie qui prend en charge l’adresse actuelle. Pour plus d’informations sur les TSP fournis avec Windows 2000, consultez À propos du fournisseur de services de téléphonie (TSP). Pour les fournisseurs de services de sécurité tiers, consultez la documentation fournie par le distributeur.

Syntaxe

HRESULT CreateCall(
  [in]  BSTR               pDestAddress,
  [in]  long               lAddressType,
  [in]  long               lMediaTypes,
  [out] ITBasicCallControl **ppCall
);

Paramètres

[in] pDestAddress

Cette chaîne BSTR contient une adresse de destination. Le format est spécifique au fournisseur. Ce pointeur peut être NULL pour les adresses sans numérotation (par exemple avec un téléphone à chaud) ou lorsque tous les appels sont effectués à l’aide de ITBasicCallControl ::D ial. Null en combinaison avec un pGroupIDNULL dans ITBasicCallControl ::P ickup entraîne un regroupement. Les fournisseurs de services qui ont des fonctionnalités de multiplexage inverse peuvent autoriser une application à spécifier plusieurs adresses à la fois.

[in] lAddressType

Contient une constante de type d’adresse , telle que LINEADDRESSTYPE_PHONENUMBER, qui décrit le format de l’adresse. La valeur doit être valide pour cette adresse. Utilisez ITAddressCapabilities ::get_AddressCapability avec AddressCap définie sur AC_ADDRESSTYPES pour vérifier la valeur.

[in] lMediaTypes

Identifie le ou les types de média qui seront impliqués dans la session d’appel.

[out] ppCall

Pointeur vers l’interface ITBasicCallControl .

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a réussi.
E_INVALIDARG	Le type d’adresse , lAddressType, n’est pas valide ou spécifie plusieurs types d’adresse.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
E_POINTER	Le paramètre ppCall n’est pas un pointeur valide.

Remarques

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

Lorsque le type d’adresse est LINEADDRESSTYPE_SDP, l’application doit appeler la méthode ITSDP ::get_IsValid sur pDestAddress pour vérifier que les informations SDP contenues sont correctement construites conformément à la RFC 2327.

Les appels utilisés en tant qu’appels de consultation, tels que lors d’une conférence, d’un transfert ou d’une opération de transfert, doivent être créés à l’aide de cette méthode.

TAPI appelle la méthode AddRef sur l’interface ITBasicCallControl retournée par ITAddress ::CreateCall. L’application doit appeler Release sur l’interface ITBasicCallControl pour libérer les ressources qui lui sont associées.

Note Cette méthode n’est pas exactement la même que lineMakeCall dans TAPI 2. Il fournit à TAPI une grande partie des mêmes informations, mais les opérations parallèles ne sont pas effectuées tant que ITBasicCallControl ::Connect n’est pas appelé.