IP Office 4.0 Manuel du développeur TAPI Link

Transcription

1 IP Office 4.0 Manuel du développeur TAPI Link Version 11 ( )

2 2006 Avaya Inc. Tous droits réservés. Note Bien que tous les efforts nécessaires aient été mis en œuvre en vue de s assurer que les informations contenues dans ce document sont complètes et exactes au moment de l impression, Avaya Inc. ne peut assumer aucune responsabilité concernant toute erreur éventuelle. Les informations contenues dans ce document sont susceptibles d être amendées et modifiées lors de versions ultérieures. Avis de non responsabilité concernant la documentation Avaya Inc. ne peut être tenu responsable de toute modification, ajout ou suppression effectués dans la version publiée d origine de cette documentation, sauf si ces modifications, ajouts ou suppressions sont effectués par Avaya. Avis de non responsabilité concernant les liens Avaya Inc. n est pas responsable du contenu ou de la fiabilité des sites Web pour lesquels un lien apparaît dans la présente documentation et Avaya ne cautionne pas nécessairement les produits, les services ou les informations qui y sont décrits ou proposés. Nous ne pouvons garantir le fonctionnement permanent des liens et n'avons aucun contrôle sur la disponibilité des pages liées. Licence L UTILISATION OU L INSTALLATION DE CE PRODUIT INDIQUE QUE L UTILISATEUR FINAL ACCEPTE LES CONDITIONS DÉFINIES ICI ET LES CONDITIONS GÉNÉRALES DE LICENCE DISPONIBLES SUR LE SITE AVAYA («GENERAL LICENSE TERMS - CONDITIONS GÉNÉRALES DE LICENCE»). SI VOUS NE SOUHAITEZ PAS ÊTRE LIÉ PAR CES CONDITIONS, VOUS DEVEZ RETOURNER LE(S) PRODUIT(S) AU POINT DE VENTE DANS LES DIX (10) JOURS À COMPTER DE LA DATE DE LIVRAISON POUR OBTENIR UN REMBOURSEMENT OU UN AVOIR. Avaya accorde à l'utilisateur final une licence dans le cadre des types de licence décrits ci-dessous. Le nombre de licences et unités de capacité applicable pour lequel la licence est accordée est de un (1), à moins qu'un autre nombre de licences ou unités de capacité soit spécifié dans la documentation ou les autres documents à la disposition de l'utilisateur final. «Processeur désigné» désigne un dispositif informatique indépendant. «Serveur» désigne un processeur désigné qui héberge une application logicielle à laquelle de multiples utilisateurs peuvent accéder. Le terme «Logiciel» désigne des programmes informatiques en code exécutable, initialement mis sous licence par Avaya et utilisés par l Utilisateur final, qu il s agisse de produits autonomes ou pré installés sur le Matériel. Le terme «Matériel» désigne les produits matériels standard, initialement vendus par Avaya et utilisés par l Utilisateur final. Type(s) de licence : Licence de Système(s) désigné(s) (DS). L'utilisateur final peut installer et utiliser chaque copie du logiciel sur un seul processeur désigné, à moins qu'un autre nombre de processeurs désignés soit indiqué dans la documentation ou les autres documents à la disposition de l'utilisateur final. Avaya peut exiger que le processeur désigné (ou les processeurs désignés) soit identifié par type, numéro de série, touche de fonction, emplacement ou autre élément spécifique, ou qu'il soit fourni par l'utilisateur final à Avaya par un moyen électronique établi par Avaya dans ce but. Droit d auteur Sauf indication expresse contraire, le Produit est protégé par des droits d auteur et autres législations respectant les droits de propriété. La reproduction, l'utilisation ou le transfert non autorisé peut constituer un délit dans le cadre de la loi applicable. Composants tiers Certains programmes logiciels ou parties de ces programmes inclus dans le Produit peuvent contenir un logiciel distribué dans le cadre d accord avec des tiers («Third Party Components - Composants tiers»), qui peuvent contenir des conditions qui étendent ou limitent les droits d utilisation de certaines parties du Produit («Third Party Terms - Conditions relatives aux tiers»). Les informations identifiant les composants tiers et les conditions relatives aux tiers qui s y appliquent sont disponibles sur le site d Avaya à l adresse suivante : Intervention d Avaya en cas de fraude Si vous pensez être victime d une fraude téléphonique et avez besoin d assistance technique ou de support, appelez la ligne d intervention en cas de fraude téléphonique au centre de support technique au pour les États-Unis et le Canada. Tout point faible soupçonné en matière de sécurité des produits d'avaya doit être signalé à Avaya par courrier électronique à l adresse suivante : securityalerts@avaya.com. Pour obtenir d autres numéros de téléphone d assistance, consultez le site d assistance d Avaya (

3 Table des matières TAPI Link IP Office... 1 Présentation... 1 Pilote IP Office TAPI... 1 Avis de non-responsabilité... 1 Références... 2 Structure de ce document... 2 Installer les pilotes TAPILink et Wave... 3 Installer la licence CTI TAPI Linkpro et les licences Wave... 3 Configurer le pilote TAPI... 3 Configurer IP Office pour TAPI... 5 Présentation... 5 TAPI TAPI Référence TAPI 2.x... 7 Fonctions TAPI... 7 Fonctions TAPI... 7 lineaddtoconference... 8 lineanswer... 8 lineblindtransfer... 8 linecompletetransfer... 9 lineconfigdialog... 9 lineclose... 9 linedeallocatecall... 9 linedevspecific linedial linedrop linegeneratedigits linegeneratetone...14 linegetaddresscaps linegetaddressid linegetaddressstatus linegetapppriority...15 linegetcallinfo linegetcallstatus linegetdevcaps linegetid linegetlinedevstatus linehandoff linehold lineinitializeex linemakecall linemonitordigits linemonitortone linenegotiateapiversion lineopen linepark lineredirect lineremovefromconference linesetapppriority...23 linesetappspecific linesetcallprivilege linesetstatusmessages linesetuptransfer lineshutdown lineswaphold Manuel du développeur TAPI Link Page iii IP Office Version 11 ( )

4 Manuel du développeur TAPI Link lineunhold lineunpark Structures TAPI LINEADDRESSCAPS LINEADDRESSSTATUS LINECALLINFO LINECALLPARAMS LINECALLSTATUS LINEDEVCAPS Evénements TAPI (Messages) LINE_APPNEWCALL LINE_CALLINFO LINE_CALLSTATE LINE_LINEDEVSTATE LINE_DEVSPECIFIC LINE_ADDRESSSTATE Référence TAPI TAPI TAPI ITTAPI Address Adresse ITAddress IEnumAddress ITMediaSupport Terminal Call Appeler ITCallInfo ITBasicCallControl ITCallStateEvent ITCallNotificationEvent ITCallInfoChangeEvent Concentrateur d appel Types énumérés TAPI CALL_STATE CALLINFO_STRING...48 DISCONNECT_CODE CALL_STATE_EVENT_CAUSE Fournisseur de service média IP Office A propos du MSP Utiliser le MSP Utiliser les interfaces spécifiques aux périphériques ITACDAgent ITGroup ITDivert ITPlay IPOfficePrivateEvents Utiliser les capacités média continues du MSP Index Page iv Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

5 TAPI Link IP Office Présentation Le logiciel IP Office CTI Link est disponible dans les versions Lite et Pro, qui constituent des interfaces d exécution permettant l utilisation des applications. Le Kit de développement du logiciel (SDK) contient de la documentation relative aux interfaces Lite et Pro destinées aux développeurs de logiciel. Les versions Lite et Pro contiennent le même programme. La fonction supplémentaire offerte par la version IP Office CTI Link Pro s active après l installation de la clé de licence de CTI Link Pro. Pour plus d informations, consultez le manuel d installation de CTI Link IP Office. Ce document fournit des informations pour aider les développeurs à mettre en œuvre une application qui utilise le fournisseur de service TAPI IP Office. Il est supposé dans cette documentation que le développeur connaît déjà TAPI. Il est également recommandé que le lecteur de ce document ait accès à la bibliothèque MSDN qui fournit une documentation complète sur TAPI. Pilote IP Office TAPI L architecture de Windows permet aux développeurs de mettre en œuvre des applications en utilisant les interfaces de programmation d applications (API) standard, quel que soit le matériel de téléphonie utilisé. Les fabricants du matériel de téléphonie fournissent les pilotes de téléphonie, appelés fournisseurs de service de téléphonie (TSP), qui sont installés sur Windows. Ces TSP fournissent le lien entre TAPI et le matériel de téléphonie. Le pilote TAPI pour IP Office prend en charge toutes les versions TAPI de 2.0 à 3.0. Avis de non-responsabilité Veuillez noter que, en dépit des efforts d Avaya pour que le pilote TAPI IP Office soit compatible avec toutes les versions précédentes du pilote TAPI IP Office, en termes d ensemble de fonctionnalités offertes, Avaya ne peut garantir que le comportement d IP Office reste inchangé. En raison des améliorations d IP Office, la séquence, l heure et le contenu précis des événements TAPI sont susceptibles de changer. Il est recommandé aux développeurs d utiliser un modèle de programmation régi par les événements pour que les applications ne soient pas affectées par ces changements. Manuel du développeur TAPI Link Page 1 IP Office Version 11 ( )

6 Manuel du développeur TAPI Link Références Il est recommandé de lire les documents suivants : MSDN / Plateforme SDK Programmation de téléphonie Windows (TAPI 1.x et 2.x) Manuel d installation CTI Link Structure de ce document Le reste de ce document est constitué des sections suivantes : Référence TAPI 2 Référence par ordre alphabétique des fonctions TAPI Référence par ordre alphabétique des structures TAPI Référence par ordre alphabétique des événements TAPI Référence TAPI 3 Types d énumération TAPI 3 MSP (fournisseur de service média) Perte et récupération de la communication Page 2 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

7 Installer les pilotes TAPILink et Wave TAPI Link IP Office Le fournisseur de service TAPI de IP Office et le pilote Wave sont installés à partir du CD-ROM de l utilisateur IP Office. Pour plus d informations, consultez le manuel d installation de CTI Link. Installer la licence CTI TAPI Linkpro et les licences Wave Vous n avez pas besoin de licence pour utiliser le pilote TAPI, mais la licence fournit les fonctions complémentaires suivantes : Mode utilisateur tiers. Surveillance des files d attente ACD Fonction linedevspecific activée Pour utiliser la fonctionnalité Wave, vous devez installer une licence utilisateur Wave pour chaque utilisateur Wave, en plus de la licence CTI Link Pro. Configurer le pilote TAPI Le fournisseur de services IP Office TAPI peut fonctionner en mode mono-utilisateur ou utilisateur tiers. Pour activer le mode utilisateur tiers, vous devez acheter une licence. Notez que les versions sans licence (Lite) ne vous empêchent pas de sélectionner cette option, mais elle ne sera pas activée. Le mode mono-utilisateur signifie que l application TAPI est susceptible de contrôler et/ou surveiller un seul dispositif téléphonique. Le mode utilisateur tiers signifie que l application TAPI est susceptible de contrôler et/ou surveiller les dispositifs téléphoniques d une unité IP Office particulière. Mode mono-utilisateur Saisissez l adresse IP de l unité IP Office dans la case intitulée Adresse IP du commutateur. Sélectionnez l option Mono-utilisateur. Saisissez le nom d utilisateur et le mot de passe du poste à surveiller et/ou contrôler à l aide de TAPI. Normalement, le nom d utilisateur correspond au nom de la personne associée à un poste téléphonique physique. Manuel du développeur TAPI Link Page 3 IP Office Version 11 ( )

8 Manuel du développeur TAPI Link Mode Utilisateur tiers Saisissez l adresse IP de l unité IP Office dans la case intitulée Adresse IP du commutateur. Sélectionnez l option Utilisateur tiers. Saisissez le mot de passe du commutateur. Il s agit du mot de passe saisi dans Manager lors du chargement de la configuration du commutateur. Le mode utilisateur tiers fournit, par défaut, une ligne TAPI pour chaque poste physique relié à IP Office. Les cases à cocher associées au mode utilisateur tiers activent des entités supplémentaires à surveiller et/ou contrôler par TAPI. Files d attente ACD IP Office peut être configuré de manière à placer en file d attente les appels entrants présentés à un groupe d utilisateurs internes. Par exemple, si un groupe d agents du centre d appels a été configuré sur votre IP Office et que vous souhaitez placer tout appel entrant en attente jusqu à ce qu un agent soit disponible pour prendre cet appel. Si vous cochez la case Files d attente ACD, des lignes sont mises à disposition pour surveiller et/ou contrôler un appel par rapport à un groupe. Utilisateurs WAV Si un utilisateur possède un nom d utilisateur commençant par TAPI:, il s agit d un utilisateur WAV. Le commutateur IP Office tente de fournir un flux audio continu aux utilisateurs WAV lorsqu ils sont en ligne. Ce flux audio continu requiert que le pilote wave IP Office soit installé sur l ordinateur et que chaque utilisateur possède une instance de licence de pilote wave. Si le pilote wave n est pas installé, vous pourrez tout de même cocher la case Utilisateurs WAV et recevoir des événements utilisateur WAV sans la licence. Au cours de l utilisation, le flux audio continu TAPI WAV utilise un canal de données IP Office provenant du même groupe de canaux de données que celui utilisé pour les ports de messagerie vocale. Le nombre maximum de canaux de données disponibles simultanément pour la messagerie vocale et les appels TAPI WAV dépend du type d unité de contrôle IP Office ; IP401 = 2, IP403 et Small Office Edition = 10, IP406 = 20, IP412 = 30. Page 4 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

9 Configurer IP Office pour TAPI TAPI Link IP Office Cette section décrit la configuration de IP Office à l aide de l application Manager. Si votre application surveille des téléphones sans les contrôler, aucune configuration n?est requise. Il existe deux manières d utiliser TAPI avec IP Office : Si votre application contrôle des téléphones, il est recommandé de configurer tous les utilisateurs contrôlés en tant que station décrochée. Ainsi, le téléphone de l utilisateur passe à l état de veille lorsqu un appel est raccroché à l aide de TAPI. Si cette option n est pas définie, le téléphone reste déconnecté jusqu à ce que le téléphone soit raccroché manuellement. La case Station décrochée se situe dans l onglet Téléphonie des paramètres de l utilisateur dans Manager. Si vous avez besoin d un utilisateur spécial qui traite le flux continu de média (tel qu un standard automatique), créez un nouvel utilisateur avec un nom qui commence par TAPI:. Il s agira d un utilisateur WAV. Le numéro de l utilisateur ne doit pas être en conflit avec tout groupe ou numéro de téléphone existant. Présentation Il est recommandé de fermer les applications TAPI avant de reconfigurer le commutateur. Cela permet au fournisseur de service de téléphonie (TSP) de fermer toutes les lignes ouvertes et d assurer que le commutateur et tous les TSP connectés conservent un état consistant. En cas de perte de communication imprévue (le commutateur est accidentellement mis hors tension ou un câble réseau est accidentellement débranché), le TSP détecte qu il n est plus connecté au commutateur. Pendant ce temps, tous les appels vers les fonctions TAPI qui requièrent une communication entre le TSP et le commutateur sont rejetés. Le délai entre la perte de communication et la détection de cette perte par le TSP dépend des paramètres TCP de l ordinateur hôte et de l horloge interne du TSP. Le délai peut aller jusqu à 2 minutes. Une fois que le TSP a détecté la perte de communication avec le commutateur, il tente de rétablir une connexion. Lorsque la connexion est rétablie, le fournisseur de service peut généralement récupérer les lignes/adresses ouvertes, même lorsque la perte de communication a été causée par le redémarrage du commutateur. La façon dont la perte de communication apparaît dans l application TAPI dépend de la version de TAPI utilisée. Voir ci-dessous. TAPI 2 Lorsque le TSP perd sa connexion avec IP Office, un message LINEDEVSTATE_OUTOFSERVICE est envoyé sur toutes les lignes ouvertes. Lorsque la communication est rétablie, un message LINEDEVSTATE_INSERVICE est envoyé à chaque ligne TAPI récupérée. TAPI 3 Lorsque le TSP perd sa connexion avec IP Office, un ITAddressEvent est généré pour chaque adresse qui est inscrite pour de tels événements. Ces événements indiquent que l état de l adresse a changé. L état devient AS_OUTOFSERVICE. Lorsque le TSP rétablit sa connexion avec IP Office, aucun événement n est généré. Cependant, une fois la communication rétablie, toutes les adresses TAPI 3 ouvertes sont récupérées. Manuel du développeur TAPI Link Page 5 IP Office Version 11 ( )

10

11 Référence TAPI 2.x Fonctions TAPI Fonctions TAPI Cette section décrit chaque fonction TAPI2.x prise en charge par le pilote TAPI IP Office. Elle décrit les comportements ou limitations spécifiques de ces fonctions lorsqu elles sont utilisées avec IP Office. lineaddtoconference lineanswer lineblindtransfer linecompletetransfer lineconfigdialog lineclose linedeallocatecall linedevspecific linedial linedrop linegeneratedigits linegeneratetone linegetaddresscaps linegetaddressid linegetaddressstatus linegetapppriority linegetcallinfo linegetcallstatus linegetdevcaps linegetid linegetlinedevstatus linehandoff linehold lineinitializeex linemakecall linemonitordigits linemonitortone linenegotiateapiversion lineopen linepark lineredirect lineremovefromconference linesetapppriority linesetappspecific linesetcallprivilege linesetstatusmessages linesetuptransfer lineshutdown lineswaphold lineunhold lineunpark Manuel du développeur TAPI Link Page 7 IP Office Version 11 ( )

12 Manuel du développeur TAPI Link lineaddtoconference Ajoute l appel à la conférence. lineaddtoconference( HCALL hconfcall, HCALL hconsultcall lineanswer Répond à un appel qui est présenté à l application. lineanswer( HCALL hcall, LPCSTR lpsuseruserinfo, DWORD dwsize Remarque UserUserInfo n est pas pris en charge et est ignoré. lineblindtransfer Cette fonction peut être utilisée pour transférer un appel en cours à un tiers. Le code du pays est ignoré. lineblindtransfer( HCALL hcall, LPCSTR lpszdestaddress, DWORD dwcountrycode Page 8 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

13 linecompletetransfer Référence TAPI 2.x Cette fonction peut être utilisée pour terminer un transfert ou la configuration d un appel de conférence. Cette fonction est supposée renvoyer une ID d appel à la conférence, mais elle renvoie toujours zéro. linecompletetransfer( HCALL hcall, HCALL hconsultcall, LPHCALL lphconfcall, DWORD dwtransfermode lineconfigdialog Affiche la même boîte de dialogue Configuration du fournisseur de service TAPI que celle qui apparaît dans le Panneau de configuration / options Téléphone et Modem (ou Téléphonie). Le paramètre lpszdeviceclass est ignoré. lineconfigdialog( DWORD dwdeviceid, HWND hwndowner, LPCSTR lpszdeviceclass lineclose Ferme une ligne. N utilisez cette fonction que lorsque vous ne voulez plus effectuer, recevoir ou contrôler des appels sur une ligne. lineclose( HLINE hline linedeallocatecall Supprime les ressources associées à un appel. Cette fonction ne doit être utilisée que lorsque l appel est en mode de veille. linedeallocatecall( HCALL hcall Manuel du développeur TAPI Link Page 9 IP Office Version 11 ( )

14 Manuel du développeur TAPI Link linedevspecific linedevspecific Le TSPI offre une fonctionnalité étendue grâce à la fonction linedevspecific. Remarque : Elle n est disponible que dans la version sous licence du pilote TAPI. La fonction linedevspecific de TAPI prend une mémoire tampon et la transmet, intacte, au TSP où elle est interprétée comme des commandes spécifiques au périphérique. Les types de commandes sont décrits dans les paragraphes suivants : linedevspecific( HLINE hline, DWORD dwaddressid, HCALL hcall, LPVOID lpparams, DWORD dwsize Protocole de connexion Pour connecter un agent ACD à une ligne surveillée, définissez le premier octet de la mémoire tampon à 8. Les octets suivants doivent être une chaîne de caractères qui décrit le poste qui se connecte. Considérons donc la mémoire tampon suivante, utilisée pour connecter l agent 218 à la ligne que nous avons appelée linedevspecific : - unsigned char buf[6]; int len = 6; buf[0] = 8; // Constante signifiant Connexion buf[1] = 2 ; buf[2] = 1 ; buf[3] = 8 ; buf[4] = 0; // N oubliez pas la terminaison nulle. Se déconnecter Vous pouvez vous déconnecter en transmettant la mémoire tampon suivante à la fonction DevSpecific : unsigned char buf[3]; int len = 3; buf[0] = 9; // Constante signifiant Code de fonction buf[1] = 47; // Constante signifiant Déconnexion buf[2] = 0; // N oubliez pas la terminaison nulle. Page 10 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

15 Destination de renvoi Référence TAPI 2.x Pour définir la destination des appels renvoyés, envoyez 9 dans le premier octet, 6 dans le second et les octets suivants doivent être une chaîne de caractères représentant le poste de destination du renvoi. Par exemple, pour définir la destination de renvoi au poste 236, envoyez la mémoire tampon suivante : unsigned char buf[6]; int len = 6; buf[0] = 9; // Les deux premiers octets sont des constantes devspecific buf[1] = 6; buf[2] = 2 ; buf[3] = 3 ; buf[4] = 6 ; buf[5] = 0; // N oubliez pas la terminaison nulle. Voyant de message en attente Certains téléphones possèdent des voyants qui s allument lorsque la messagerie vocale de l utilisateur contient des nouveaux messages. Le nombre de messages en attente peut être contrôlé par une commande devspecific spécifique. S il n y a aucun nouveau message, le voyant s éteint. S il y a au moins un nouveau message, le voyant s allume. Envoyez la mémoire tampon suivante à linedevspecific : unsigned char buf[21]; int len = 21; buf[0] = 9; // Code de fonction buf[1] = 73; // Définir le voyant de message en attente sprintf(&(buffer[2]), ";Mailbox Msgs=%d", num // num correspond au nombre de messages Remarque Le serveur IP Office ou d autres applications IP Office peuvent également contrôler le voyant de messages en attente. Manuel du développeur TAPI Link Page 11 IP Office Version 11 ( )

16 Manuel du développeur TAPI Link Paramètres de renvoi Les constantes suivantes aident à activer et désactiver les fonctions de renvoi. const unsigned char ForwardAllOn = 0; const unsigned char ForwardAllOff = 1; const unsigned char ForwardBusyOn = 2; const unsigned char ForwardBusyOff = 3; const unsigned char ForwardNoAnswerOn = 4; const unsigned char ForwardNoAnswerOff = 5; const unsigned char DoNotDisturbOn = 7; const unsigned char DoNotDisturbOff = 8; Une mémoire tampon qui utilise ces constantes doit être longue de trois octets et doit commencer par un 9. Par exemple, le code suivant active la ligne Ne pas déranger. unsigned char buf[3]; int len = 3; buf[0] = 9; buf[1] = DoNotDisturbOn; buf[2] = 0; Activer/Désactiver le groupe Envoyez la mémoire tampon suivante pour activer l appartenance de l utilisateur au groupe possédant le poste groupnum. unsigned char buf[10]; int len = 10; buf[0] = 9; buf[1] = 76; sprintf((char*)&buf[2], "%d", groupnum Envoyez la mémoire tampon suivante pour désactiver l appartenance de l utilisateur au groupe possédant le poste groupnum. unsigned char buf[10]; int len = 10; buf[0] = 9; buf[1] = 77; sprintf((char*)&buf[2], "%d", groupnum Dans les deux cas (activation ou désactivation de l appartenance au groupe), vous pouvez désactiver ou activer toutes les appartenances en omettant le numéro du numéro de groupe et en le remplaçant par zéro (soit, buf[2] = 0). Remarque Vous ne pouvez qu activer et désactiver un utilisateur que des groupes auxquels il appartient, comme configuré dans Manager. Page 12 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

17 Intrusion Référence TAPI 2.x Envoyez la mémoire tampon suivante pour intervenir dans les appels d autres appelants. Le destinataire de l appel dans lequel vous intervenez est identifié par la classe enveloppante extnnum. unsigned char buf[10]; int len = 10; buf[0] = 9; // Code de fonction buf[1] = 83; // Intervenir sprintf((char*)&buf[2], "%d", extnnum Écouter Envoyez la mémoire tampon suivante pour écouter les appels d autres appelants. Le destinataire de l appel que vous écoutez est identifié par la classe enveloppante extnnum. unsigned char buf[10]; int len = 10; buf[0] = 9; // Code de fonction buf[1] = 100; // Écouter sprintf((char*)&buf[2], "%d", extnnum linedial Cette fonction est utilisée pour appeler un numéro au cours d un appel existant. Elle peut être utilisée dans un transfert supervisé (voir linesetuptransfer). Le code du pays est ignoré. linedial( HCALL hcall, LPCSTR lpszdestaddress, DWORD dwcountrycode linedrop Met fin à un appel. UserUserInfo n est pas pris en charge et est ignoré. linedrop( HCALL hcall, LPCSTR lpsuseruserinfo, DWORD dwsize Manuel du développeur TAPI Link Page 13 IP Office Version 11 ( )

18 Manuel du développeur TAPI Link linegeneratedigits Utilisez cette fonction pour générer des chiffres DTMF lors d un appel. Il n est pas nécessaire que l utilisateur soit un utilisateur WAV ni qu un pilote wave soit installé pour agir sur l appel. Un message LINE_GENERATE est envoyé à l application à la fin de la création de ces chiffres. Le seul dwdigitmode pris en charge est LINEDIGITMODE_DTMF. linegeneratedigits( HCALL hcall, DWORD dwdigitmode, LPCSTR lpszdigits, DWORD dwduration linegeneratetone Cette fonction peut être utilisée pour créer un bip sonore lors de l appel. La ligne doit appartenir à un utilisateur WAV et le pilote wave doit être installé pour agir sur l appel. La seule valeur prise en charge pour dwtonemode est LINETONEMODE_BEEP. Les sonneries personnalisées n étant pas prises en charge, dwnumtones doit être zéro. linegeneratetone( HCALL hcall, DWORD dwtonemode, DWORD dwduration, DWORD dwnumtones, LPLINEGENERATETONE const lptones linegetaddresscaps Récupère les capacités téléphoniques d une adresse particulière pour une ligne particulière. Les capacités sont renvoyées dans la structure LINEADDRESSCAPS. Voir LINEADDRESSCAPS dans la section sur les structures TAPI pour de plus amples informations. Les lignes IP Office ont toujours une adresse unique. linegetaddresscaps( HLINEAPP hlineapp, DWORD dwdeviceid, DWORD dwaddressid, DWORD dwapiversion, DWORD dwextversion, LPLINEADDRESSCAPS lpaddresscaps Page 14 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

19 linegetaddressid Référence TAPI 2.x Cette fonction est utilisée pour mapper un numéro de téléphone (adresse) attribué à un dispositif de ligne à son dwaddressid dans la plage comprise entre zéro et le numéro des adresses moins un renvoyé dans les capacités du dispositif de la ligne. (LINEDEVCAPS). Si dwnumaddresses est 1 dans LINEDEVCAPS, alors cette fonction renvoie toujours 0 dans DWORD indiqué par lpdwaddressid. linegetaddressid( HLINE hline, LPDWORD lpdwaddressid, DWORD dwaddressmode, LPCSTR lpsaddress, DWORD dwsize linegetaddressstatus Cette fonction permet à une application de demander l état actuel d une adresse spécifique. Voir LINEADDRESSSTATUS dans la section sur les structures TAPI pour de plus amples informations. linegetaddressstatus( HLINE hline, DWORD dwaddressid, LPLINEADDRESSSTATUS lpaddressstatus linegetapppriority Récupère la priorité de vos applications. linegetapppriority( LPCSTR lpszappfilename, DWORD dwmediamode, LPLINEEXTENSIONID lpextensionid, DWORD dwrequestmode, LPVARSTRING lpextensionname, LPDWORD lpdwpriority Manuel du développeur TAPI Link Page 15 IP Office Version 11 ( )

20 Manuel du développeur TAPI Link linegetcallinfo Obtient les informations fixes sur l appel spécifié. Voir la structure LINECALLINFO pour de plus amples informations. linegetcallinfo( HCALL hcall, LPLINECALLINFO lpcallinfo linegetcallstatus Cette fonction récupère une structure LINECALLSTATUS relative à un appel existant. Voir LINECALLSTATUS dans la section sur les structures TAPI pour de plus amples informations. linegetcallstatus( HCALL hcall, LPLINECALLSTATUS lpcallstatus linegetdevcaps Utilisez cette fonction pour récupérer la structure LINEDEVCAPS. Voir LINEDEVCAPS dans la section sur les structures TAPI pour de plus amples informations. linegetdevcaps( HLINEAPP hlineapp, DWORD dwdeviceid, DWORD dwapiversion, DWORD dwextversion, LPLINEDEVCAPS lplinedevcaps linegetid Obtenez l ID d une ligne lorsque dwselect est LINECALLSELECT_LINE. linegetid( HLINE hline, DWORD dwaddressid, HCALL hcall, DWORD dwselect, LPVARSTRING lpdeviceid, LPCSTR lpszdeviceclass Page 16 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

21 linegetlinedevstatus Référence TAPI 2.x La fonction linegetlinedevstatus renvoie une mémoire tampon spécifique au périphérique. La mémoire tampon devspecific contient les informations suivantes : linegetlinedevstatus( HLINE hline, LPLINEDEVSTATUS lplinedevstatus Octet Contient Commentaire 0..n Poste téléphonique Il s agit du numéro de ligne surveillé, sous la forme d une chaîne de caractères (par exemple, 217 ). n+1 0 Terminaison nulle pour la chaîne ci-dessus. n+2 Renvoi sur occupation 1 si le téléphone est configuré pour le renvoi sur occupation, sinon 0. n+3 Renvoi sur non réponse 1 si le téléphone est configuré pour le renvoi sur non réponse, sinon 0. n+4 Renvoi inconditionnel 1 si le téléphone est configuré pour renvoyer tous les appels. n+5 Drapeau Renvoi des appels du groupe de recherche de ligne 1 si le téléphone est configuré pour renvoyer les appels du groupe de recherche de ligne. n+6 Ne pas déranger 1 si le téléphone est configuré sur Ne pas déranger. n+7 Drapeau Appel sortant interdit 1 si le téléphone est bloqué et ne peut effectuer d appels sortant. n+8 Drapeau Appel en attente 1 si l appel en attente est activé pour ce téléphone. n+9 Drapeau Messagerie vocale activée n+10 Drapeau Rappel de messagerie vocale n+11 Nombres de messages de messagerie vocale lus n+12 Nombre de messages de messagerie vocale non lus n+13 Numéro de séquence d appel externe n+14 Numéro de séquence d appel interne n+15 Numéro de séquence de rappel 1 si la messagerie vocale est activée pour ce téléphone. 1 si le rappel de la messagerie vocale est activé pour ce téléphone. Le nombre de messages lus. Le nombre de messages de messagerie vocale en attente pour l utilisateur. Type de sonnerie pour les appels externes. Type de sonnerie pour les appels internes. Type de sonnerie pour les rappels. Manuel du développeur TAPI Link Page 17 IP Office Version 11 ( )

22 Manuel du développeur TAPI Link n+16 Temporisation d absence de réponse n+17 Durée de conclusion d appel n+18 Drapeau Intrusion autorisée n+19 Drapeau Intrusion non autorisée Nombre de secondes pendant lesquelles le téléphone sonne avant de suivre l action sans réponse, comme par exemple, renvoyer sur non réponse et transférer à la messagerie vocale. Nombre de secondes pendant lesquelles le téléphone ne peut accepter de nouvel appel, suite à un appel. 1 si le téléphone peut intervenir dans les appels. 1 si l on ne peut pas intervenir sur ce téléphone. n+20 Drapeau Répertoire X 1 si cet utilisateur n apparaît pas dans le répertoire interne. n+21 Drapeau Forcer la connexion À l état déconnecté lors de la mise sous tension, l utilisateur doit donc se connecter. n+22 Drapeau Code client forcé 1 si le téléphone est forcé de fournir un code client valide pour effectuer des appels externes. n+23 Drapeau Code de connexion n+24 Drapeau Téléphone système 1 si l utilisateur a un code de connexion configuré. 1 s il s agit d un téléphone système. n+25 ID du message d absence ID du message d absence. n+26 Drapeau Définir le message d absence n+27 Mode courrier électronique de la messagerie vocale 1 si le message d absence avec l ID dans le champ précédent s affichent sur le téléphone. 1 si le mode courrier électronique de la messagerie vocale est activé. n+28..m Poste Le poste de l utilisateur, qui peut être différent du poste téléphonique. m+1 0 Terminaison nulle pour la chaîne Poste ci-dessus. m+2..p Paramètres régionaux Les paramètres régionaux de l utilisateur. p+1 0 Terminaison nulle pour les paramètres régionaux. p+2..q Destination du transfert Le numéro vers lequel ce téléphone est configuré pour renvoyer les appels. q+1 0 Terminaison nulle pour la destination ci-dessus. q+2..r r+1 0 Numéro de renvoi temporaire Tous les appels sont redirigés vers ce numéro. r+2..s Texte d absence Le texte d absence défini pour ce téléphone. s+1 0 Page 18 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

23 s+2..t Liste d exceptions à Ne pas déranger Référence TAPI 2.x Une liste de numéros qui sont autorisés à sonner sur le téléphone pendant que celui-ci est en mode Ne pas déranger. Chaque numéro est une chaîne à terminaison nulle. Le dernier numéro de la liste se termine par deux valeurs nulles (le champ t+1 représente la seconde valeur nulle). Si la liste est vide, alors les donnés contiennent une seule valeur nulle (représentée par t+1). t+1 0 t+2..u Numéro de transfert sur occupation Le numéro auquel seront transférés les appels lorsque ce téléphone est occupé. u+1 0 u+2 Priorité de l utilisateur Cette priorité est associée à tous les appels effectués par cet utilisateur. u+3 Appartenance au groupe Cet octet contient le nombre de groupes dans lesquels l utilisateur est actuellement activé. u+4 Groupes en dehors des heures Nombre de groupes auxquels appartient l utilisateur actuellement en dehors de leur profil horaire. u+5 Groupes désactivés Nombre de groupes actuellement désactivés pour l utilisateur. u+6 Groupes hors service Nombre de groupes auxquels appartient l utilisateur actuellement hors service. u+7 Groupes service de nuit Nombre de groupes auxquels appartient l utilisateur actuellement en service de nuit. linehandoff La fonction linehandoff transmet l appel spécifié à une autre application qui en devient propriétaire. linehandoff( HCALL hcall, LPCSTR lpszfilename, DWORD dwmediamode linehold Cette fonction met en attente un appel en cours. linehold( HCALL hcall Manuel du développeur TAPI Link Page 19 IP Office Version 11 ( )

24 Manuel du développeur TAPI Link lineinitializeex Il s agit de la première fonction TAPI qui doit être utilisée pour initialiser TAPI. Le paramètre lpdwapiversion doit être défini à au moins 0x lineinitializeex( LPHLINEAPP lphlineapp, HINSTANCE hinstance, LINECALLBACK lpfncallback, LPCSTR lpszfriendlyappname, LPDWORD lpdwnumdevs, LPDWORD lpdwapiversion, LPLINEINITIALIZEEXPARAMS lplineinitializeexparams linemakecall Cette fonction effectue un appel. Voir la section sur les paramètres d appel à la fin du chapitre sur les fonctions TAPI. linemakecall( HLINE hline, LPHCALL lphcall, LPCSTR lpszdestaddress, DWORD dwcountrycode, LPLINECALLPARAMS const lpcallparams linemonitordigits Utilisez cette fonction pour activer la détection des chiffres DTMF. Cette fonction est uniquement opérationnelle lorsque le pilote wave IP Office est impliqué dans l appel et que l utilisateur est un utilisateur WAV (Voir la section sur les Utilisateurs WAV ). La détection se fait en analysant les échantillons média dans le pilote WAV. Lorsqu une sonnerie DTMF est détectée, un message LINE_MONITORDIGITS est envoyé à l application. dwdigitmodes peut être LINEDIGITMODE_DTMF et/ou LINEDIGITMODE_DTMFEND. Utilisez linemonitordigits avec un dwdigitmode de zéro pour annuler la détection des chiffres DTMF. linemonitordigits( HCALL hcall, DWORD dwdigitmodes Page 20 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

25 linemonitortone Référence TAPI 2.x Cette fonction, comme la fonction ci-dessus, requiert l implication d un pilote wave dans l appel. De plus, elle peut être utilisée pour détecter un silence. Les fréquences de la structure LINEMONITORTONE indiquée par lptonelist doivent toutes être de zéro. Si un silence est détecté, un message LINE_MONITORTONE est envoyé à l application. Utilisez linemonitortone avec lptonelist défini sur NUL pour annuler la détection de silence. linemonitortone( HCALL hcall, LPLINEMONITORTONE const lptonelist, DWORD dwnumentries linenegotiateapiversion Cette fonction doit être utilisée immédiatement après lineinitializeex pour assurer que les notifications TAPI correctes sont envoyées à votre application. Elle doit être utilisée pour chaque ligne utilisée par votre application. linenegotiateapiversion( HLINEAPP hlineapp, DWORD dwdeviceid, DWORD dwapilowversion, DWORD dwapihighversion, LPDWORD lpdwapiversion, LPLINEEXTENSIONID lpextensionid Manuel du développeur TAPI Link Page 21 IP Office Version 11 ( )

26 Manuel du développeur TAPI Link lineopen Cette fonction ouvre un dispositif de ligne. dwmediamodes doit être défini à LINEMEDIAMODE_INTERACTIVEVOICE pour ISDN / T1 et à LINEMEDIAMODE_UNKNOWN pour les lignes de réseau analogiques. Vous pouvez spécifier les deux pour traiter les appels des deux types de lignes de réseau. lineopen( HLINEAPP hlineapp, DWORD dwdeviceid, LPHLINE lphline, DWORD dwapiversion, DWORD dwextversion, DWORD dwcallbackinstance, DWORD dwprivileges, DWORD dwmediamodes, LPLINECALLPARAMS const lpcallparams Remarque Si vous essayez d ouvrir une ligne qui est associée à un utilisateur Wave et qu aucune licence utilisateur Wave n est installée dans IP Office, lineopen renvoie LINEERR_RESOURCEUNAVAIL. Pour de plus amples informations sur les utilisateurs Wave, consultez la section Utilisateurs WAV. linepark Cette fonction parque un appel. Seul le mode de parcage LINEPARKMODE_DIRECTED est pris en charge. L adresse de parcage peut être une chaîne alphanumérique. Toutefois, seuls des chiffres numériques peuvent être saisis sur le téléphone. Il est donc préférable de limiter vos adresses de parcage à des chaînes numériques. Les quatre adresses de parcage par défaut qui apparaissent dans Phone Manager et econsole sont 1, 2, 3 et 4. Vous devriez utiliser ces chiffres si vous voulez parquer des appels qui seront repris à l aide d applications qui utilisent cette configuration par défaut. linepark( HCALL hcall, DWORD dwparkmode, LPCSTR lpszdiraddress, LPVARSTRING lpnondiraddress Page 22 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

27 lineredirect Référence TAPI 2.x La fonction lineredirect redirige l appel spécifié vers l adresse de destination spécifiée. Le code du pays est ignoré. lineredirect( HCALL hcall, LPCSTR lpszdestaddress, DWORD dwcountrycode lineremovefromconference Supprime l appel de la conférence. lineremovefromconference( HCALL hcall linesetapppriority Utilisez cette fonction pour indiquer la priorité de vos applications. linesetapppriority( LPCSTR lpszappfilename, DWORD dwmediamode, LPLINEEXTENSIONID lpextensionid, DWORD dwrequestmode, LPCSTR lpszextensionname, DWORD dwpriority linesetappspecific Cette fonction permet à une application de définir le champ spécifique à l application de l entrée d informations sur l appel spécifié. linesetappspecific( HCALL hcall, DWORD dwappspecific Manuel du développeur TAPI Link Page 23 IP Office Version 11 ( )

28 Manuel du développeur TAPI Link linesetcallprivilege Utilisez cette fonction pour modifier les droits de propriété de vos applications pour un appel particulier. linesetcallprivilege( HCALL hcall, DWORD dwcallprivilege linesetstatusmessages Cette fonction permet à l application d indiquer les messages de notification requis. En général, dwlinestates est défini à LINEDEVSTATE_ALL et dwaddressstates à LINEADDRESSSTATE_ALL. linesetstatusmessages( HLINE hline, DWORD dwlinestates, DWORD dwaddressstates linesetuptransfer Cette fonction est utilisée pour créer un appel de consultation afin d effectuer un transfert supervisé. L appel à transférer doit déjà exister. L appel peut être actif ou en attente lorsque cette fonction est utilisée. Si l appel est actif, il sera mis en attente par cette fonction. Utilisez linedial pour appeler le destinataire vers lequel l appel doit être transféré. Utilisez linecompletetransfer pour terminer le transfert. linesetuptransfer( HCALL hcall, LPHCALL lphconsultcall, LPLINECALLPARAMS const lpcallparams lineshutdown À la fin de l utilisation des fonctions de ligne TAPI. Cette fonction est généralement utilisée lorsque vous quittez votre application. lineshutdown( HLINEAPP hlineapp Page 24 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

29 Référence TAPI 2.x lineswaphold Cette fonction met l appel actif en attente et récupère l appel en attente. lineswaphold( HCALL hactivecall, HCALL hheldcall lineunhold Cette fonction récupère un appel en attente. Cette fonction est utilisée lorsque la ligne appelle un autre interlocuteur ou a un appel actif avec un interlocuteur. L appel qui sonne, ou qui est actif, est alors abandonné avant que l appel en attente soit récupéré. lineunhold( HCALL hcall lineunpark Cette fonction récupère les appels parqués. dwaddressid doit être 0 car les lignes IP Office ont une adresse unique. lpszdestaddress doit être le même identificateur que celui utilisé lors du parcage de l appel (voir linpark). lineunpark( HLINE hline, DWORD dwaddressid, LPHCALL lphcall, LPCSTR lpszdestaddress Manuel du développeur TAPI Link Page 25 IP Office Version 11 ( )

30 Manuel du développeur TAPI Link Structures TAPI LINEADDRESSCAPS Cette structure est obtenue grâce à la fonction linegetaddresscaps. Le tableau suivant indique les valeurs obtenues pour les lignes qui se rapportent au pilote TAPI IP Office. Remarque Tous les membres de cette structure ne sont pas répertoriés. Pour de plus amples informations sur LINEADDRESSCAPS, consultez la documentation Microsoft TAPI. Membre dwlinedeviceid dwdevspecificsize Description / Valeur ID de la ligne à laquelle correspond cette adresse. Aucune information spécifique supplémentaire sur le dispositif n est transmise. dwdevspecificoffset 0 dwaddresssharing LINEADDRESSSHARING_PRIVATE dwaddressstates 0 dwcallinfostates dwcalleridflags Indique l état d informations possibles sur l appel qui peut être : LINECALLINFOSTATE_CALLID LINECALLINFOSTATE_RELATEDCALLID LINECALLINFOSTATE_NUMOWNERINCR LINECALLINFOSTATE_NUMOWNEDECR LINECALLINFOSTATE_NUMMONITORS LINECALLINFOSTATE_CALLERID LINECALLINFOSTATE_CALLEDID LINECALLINFOSTATE_REDIRECTIONID LINECALLINFOSTATE_REDIRECTINGID LINECALLINFOSTATE_DISPLAY LINECALLINFOSTATE_MONITORMODES LINECALLINFOSTATE_CALLDATA Indique les drapeaux de l ID de l appelant qui peuvent être : LINECALLPARTYID_BLOCKED LINECALLPARTYID_OUTOFAREA LINECALLPARTYID_NAME LINECALLPARTYID_ADDRESS LINECALLPARTYID_UNKNOWN LINECALLPARTYID_UNAVAIL Page 26 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

31 Référence TAPI 2.x dwcalledidflags dwconnectedidflags dwredirectionidflags dwredirectingidflags Indique les drapeaux de l ID du destinataire qui peuvent être : LINECALLPARTYID_BLOCKED LINECALLPARTYID_OUTOFAREA LINECALLPARTYID_NAME LINECALLPARTYID_ADDRESS LINECALLPARTYID_UNKNOWN LINECALLPARTYID_UNAVAIL Indique les drapeaux de l ID connectée qui peuvent être : LINECALLPARTYID_NAME LINECALLPARTYID_UNKNOWN LINECALLPARTYID_UNAVAIL Indique les drapeaux de l ID de réacheminement qui peuvent être : LINECALLPARTYID_BLOCKED LINECALLPARTYID_OUTOFAREA LINECALLPARTYID_NAME LINECALLPARTYID_ADDRESS LINECALLPARTYID_UNKNOWN LINECALLPARTYID_UNAVAIL Indique les drapeaux de l ID de transfert qui peuvent être : LINECALLPARTYID_BLOCKED LINECALLPARTYID_OUTOFAREA LINECALLPARTYID_NAME LINECALLPARTYID_ADDRESS LINECALLPARTYID_UNKNOWN LINECALLPARTYID_UNAVAIL Manuel du développeur TAPI Link Page 27 IP Office Version 11 ( )

32 Manuel du développeur TAPI Link dwcallstates Indique l état de l appel qui peut être : LINECALLSTATE_IDLE (l appel n existe plus) LINECALLSTATE_OFFERING (un nouvel appel est arrivé) LINECALLSTATE_ACCEPTED (l appel a été pris par une application) LINECALLSTATE_DIALTONE (l appelant entend une tonalité de numérotation) LINECALLSTATE_DIALING (the switch is receiving dialling information) LINECALLSTATE_RINGBACK (l appelant entend une sonnerie) LINECALLSTATE_BUSY (l appelant entend la tonalité d occupation) LINECALLSTATE_CONNECTED (l appelant a été connecté de bout en bout) LINECALLSTATE_PROCEEDING (la numérotation est terminée, mais l appel n a pas encore été connecté) LINECALLSTATE_ONHOLD (l appel est en attente) LINECALLSTATE_CONFERENCED (l appel est en conférence) LINECALLSTATE_ONHOLDPENDCONF (l appel est en attente avant de rejoindre la conférence) LINECALLSTATE_ONHOLDPENDCONF (l appel est en attente avant d être transféré) LINECALLSTATE_DISCONNECTED (l interlocuteur a abandonné l appel) LINECALLSTATE_UNKNOWN (l état de l appel est inconnu) dwdialtonemodes dwbusymodes dwspecialinfo Indique le mode de tonalité de numérotation de LINEDIALTONEMODE_UNAVAIL Indique les modes d occupation de LINEBUSYMODE_UNAVAIL Indique les informations spéciales de LINESPECIALINFO_UNAVAIL Page 28 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

33 Référence TAPI 2.x dwdisconnectmodes Indique les modes de déconnexion qui peuvent être : LINEDISCONNECTMODE_NORMAL LINEDISCONNECTMODE_REJECT LINEDISCONNECTMODE_PICKUP LINEDISCONNECTMODE_FORWARDED LINEDISCONNECTMODE_BUSY LINEDISCONNECTMODE_NOANSWER LINEDISCONNECTMODE_BADADDRESS LINEDISCONNECTMODE_UNREACHABLE LINEDISCONNECTMODE_CONGESTION LINEDISCONNECTMODE_INCOMPATIBLE LINEDISCONNECTMODE_UNAVAIL LINEDISCONNECTMODE_NODIALTONE LINEDISCONNECTMODE_QOSUNAVAIL LINEDISCONNECTMODE_BLOCKED LINEDISCONNECTMODE_DONOTDISTURB dwmaxnumactivecalls Nombre maximum d appels en cours : 1 dwmaxnumonholdcalls Nombre maximum d appels en attente : 9 dwmaxnumonholdpendingcalls Nombre maximum d appels en attente à traiter : 9 dwmaxnumconference Nombre maximum d appels de conférence : 9 dwmaxnumtransconf Nombre maximum d appels de conférence transférés : 9 dwaddrcapflags Indique les drapeaux d adresse qui peuvent être : LINEADDRCAPFLAGS_FWDNUMRINGS LINEADDRCAPFLAGS_DIALED LINEADDRCAPFLAGS_TRANSFERHELD LINEADDRCAPFLAGS_TRANSFERMAKE LINEADDRCAPFLAGS_CONFERENCEHELD LINEADDRCAPFLAGS_CONFERENCEMAKE LINEADDRCAPFLAGS_FWDSTATUSVALID Manuel du développeur TAPI Link Page 29 IP Office Version 11 ( )

34 Manuel du développeur TAPI Link dwcallfeatures Indique les fonctions d appel qui peuvent être : LINECALLFEATURE_ADDTOCONF LINECALLFEATURE_ANSWER LINECALLFEATURE_BLINDTRANSFER LINECALLFEATURE_COMPLETETRANSF LINECALLFEATURE_DIAL LINECALLFEATURE_DROP LINECALLFEATURE_GENERATEDIGITS LINECALLFEATURE_HOLD LINECALLFEATURE_PARK LINECALLFEATURE_REDIRECT LINECALLFEATURE_REMOVEFROMCONF LINECALLFEATURE_SETUPTRANSFER LINECALLFEATURE_SWAPHOLD LINECALLFEATURE_UNHOLD LINECALLFEATURE_SETCALLDATA dwremovefromconfcaps dwremovefromconfstate Indique le caps supprimer de la conférence qui est LINEREMOVEFROMCONF_ANY. Indique l état supprimer de la conférence qui est ALLSTATE_ONHOLD. dwtransfermodes Indique les modes de transfert qui peuvent être : LINETRANSFERMODE_TRANSFER LINETRANSFERMODE_CONFERENCE dwparkmodes Indique le mode de parcage de LINEPARKMODE_DIRECTED. dwforwardmodes Indique les modes de renvoi qui peuvent être : LINE FORWARDMODE_UNCOND LINE FORWARDMODE_UNCONDEXTERNAL LINE FORWARDMODE_UNCONDSPECIFIC LINE FORWARDMODE_BUSY LINE FORWARDMODE_BUSYINTERNAL LINE FORWARDMODE_BUSYEXTERNAL LINE FORWARDMODE_BUSYSPECIFIC LINE FORWARDMODE_NOANSW LINE FORWARDMODE_NOANSWINTERNAL LINE FORWARDMODE_NOANSWEXTERNAL LINE FORWARDMODE_NOANSWSPECIFIC LINE FORWARDMODE_BUSYNA LINE FORWARDMODE_BUSYNAINTERNAL LINE FORWARDMODE_BUSYNAEXTERNAL LINE FORWARDMODE_BUSYNASPECIFIC Page 30 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0

35 Référence TAPI 2.x dwmaxforwardentries Nombre maximum d entrées renvoyées : 10 dwmaxspecificentries Nombre maximum d entrées spécifiques : 10 dwminfwdnumrings Nombre minimum de sonneries lors d un renvoi : 1 dwmaxfwdnumrings Nombre maximum de sonneries lors d un renvoi : 99 dwmaxcallcompletions 0 dwcallcompletionconds 0 dwcallcompletionmodes 0 dwnumcompletionmessages 0 dwcompletionmsgtextentrysize 0 dwcompletionmsgtextsize 0 dwcompletionmsgtextoffset 0 dwaddressfeatures Indique les fonctions d adresse qui peuvent être : LINEADDRFEATURE_FORWARD LINEADDRFEATURE_MAKECALL LINEADDRFEATURE_SETUPCONF LINEADDRFEATURE_UNPARK LINEADDRFEATURE_FORWARDFWD LINEADDRFEATURE_FORWARDDND dwpredictiveautotransferstates 0 dwnumcalltreatments 0 dwcalltreatmentlistsize 0 dwcalltreatmentlistoffset 0 dwdeviceclassessize 0 dwdeviceclassesoffset 0 dwmaxcalldatasize Taille maximum des données d appel : 127 dwcallfeatures2 0 dwmaxnoanswertimeout 0 dwconnectedmodes 0 dwofferingmodes 0 dwavailablemediamodes 0 Manuel du développeur TAPI Link Page 31 IP Office Version 11 ( )

36 Manuel du développeur TAPI Link LINEADDRESSSTATUS Cette structure est obtenue par linegetaddressstatus. Remarque Tous les membres de cette structure ne sont pas répertoriés. Pour de plus amples informations sur LINEADDRESSSTATUS, consultez la documentation Microsoft TAPI. Membre Description / Valeur dwnuminuse; Toujours 1 dwnumactivecalls; dwnumonholdcalls; Toujours 0 dwnumonholdpendcalls; Toujours 0 Correspond au nombre d appels en cours. dwaddressfeatures; indique les fonctionnalités suivantes : dwnumringsnoanswer; 5 dwforwardnumentries; Toujours 0 dwforwardsize; / Toujours 0 dwforwardoffset; Toujours 0 dwterminalmodessize; Toujours 0 dwterminalmodesoffset; Toujours 0 dwdevspecificsize; Toujours 0 LINEADDRFEATURE_MAKECALL LINEADDRFEATURE_SETUPCONF LINEADDRFEATURE_UNPARK Page 32 Manuel du développeur TAPI Link Version 11 ( ) IP Office 4.0