fonction tapiRequestMakeCall (tapi.h)

La fonction tapiRequestMakeCall demande l’établissement d’un appel vocal. Une application de gestionnaire d’appels est chargée d’établir l’appel pour le compte de l’application demandente, qui est ensuite contrôlée par l’application de gestionnaire d’appels de l’utilisateur.

Syntaxe

LONG tapiRequestMakeCall(
  LPCSTR lpszDestAddress,
  LPCSTR lpszAppName,
  LPCSTR lpszCalledParty,
  LPCSTR lpszComment
);

Paramètres

lpszDestAddress

Pointeur vers un emplacement de mémoire où se trouve l’adresse de destination terminée par null de la demande d’appel. L’adresse peut utiliser le format d’adresse canonique . La validité de l’adresse spécifiée n’est pas vérifiée par cette opération. La longueur maximale de l’adresse est les caractères TAPIMAXDESTADDRESSSIZE, qui incluent la marque de fin NULL .

lpszAppName

Pointeur vers un emplacement de mémoire où se trouve le nom de l’application conviviale terminée par null de la demande d’appel. Ce pointeur peut être laissé null si l’application ne fournit pas de nom d’application. La longueur maximale de l’adresse est les caractères TAPIMAXAPPNAMESIZE, qui incluent la marque de fin NULL . Les chaînes plus longues sont tronquées.

lpszCalledParty

Pointeur vers un emplacement de mémoire où se trouve le nom de partie appelée terminée par null pour la partie appelée de l’appel. Ce pointeur peut être laissé null si l’application ne souhaite pas fournir ces informations. La longueur maximale de la chaîne est les caractères TAPIMAXCALLEDPARTYSIZE, qui incluent la marque de fin NULL . Les chaînes plus longues sont tronquées.

lpszComment

Pointeur vers un emplacement de mémoire où se trouve le commentaire terminé par null sur l’appel. Ce pointeur peut être laissé null si l’application ne fournit pas de commentaire. La longueur maximale de l’adresse est les caractères TAPIMAXCOMMENTSIZE, qui incluent la marque de fin NULL . Les chaînes plus longues sont tronquées.

Valeur retournée

Retourne zéro si la demande réussit ou un nombre d’erreur négatif si une erreur se produit. La valeur de retour d’erreur possible est la suivante :

TAPIERR_NOREQUESTRECIPIENT, TAPIERR_INVALDESTADDRESS, TAPIERR_REQUESTQUEUEFULL TAPIERR_INVALPOINTER.

Remarques

Une application de téléphonie peut demander qu’un appel soit passé en son nom en appelant tapiRequestMakeCall, en fournissant uniquement l’adresse de destination de l’appel. Cette demande est transmise à l’application de contrôle d’appel de l’utilisateur, qui place l’appel pour le compte de l’application d’origine. Une application de contrôle d’appel par défaut est fournie dans le cadre de téléphonie. Les utilisateurs peuvent le remplacer par une application de contrôle des appels de leur choix.

L’appel de tapiRequestMakeCall quand aucune application de contrôle d’appel n’est en cours d’exécution renvoie l’indication d’erreur TAPIERR_NOREQUESTRECIPIENT. Si l’application de contrôle d’appel n’est pas en cours d’exécution, TAPI tente de lancer l’application de contrôle d’appel de priorité la plus élevée (qui est répertoriée pour RequestMakeCall dans le Registre). L’appel de cette fonction lorsque la file d’attente des requêtes TAPI assistées est pleine retourne l’erreur TAPIERR_REQUESTQUEUEFULL.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	tapi.h
Bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

Informations de référence sur les services de téléphonie assistée

Vue d’ensemble de la référence TAPI 2.2