Appels CPI-C

  • Article

Cette section décrit les appels CPI-C (Common Programming Interface for Communications). Les informations suivantes sont fournies pour chaque appel :

  • Pseudonyme de l’appel et nom réel de la fonction C.

  • Définition de l’appel.

  • Liste des paramètres utilisés par l’appel et du type de données pour chaque paramètre. Le prototype de chaque fonction est déclaré dans WINCPIC. Fichier H.

  • Description de chaque paramètre d’entrée et de sortie. Les noms de paramètres sont des pseudonymes et les noms réels de ces paramètres sont déclarés par le programme d’application. La description inclut les valeurs possibles du paramètre.

  • États de conversation dans lesquels l’appel peut être émis.

  • États auxquels la conversation peut changer au retour de l’appel. Les conditions qui ne provoquent pas de changement d’état ne sont pas notées. Par exemple, les vérifications de paramètres et les vérifications d’état ne provoquent pas de changement d’état.

  • Informations supplémentaires décrivant l’utilisation de l’appel.

    Data types

    Les types de données pour les paramètres fournis à et reçus à partir de CPI-C sont établis en tant que constantes symboliques par #define instructions dans le WINCPIC. Fichier H. Par exemple, CM_INT32 représente l’int long signé et CM_PTR représente far \*. L’utilisation de constantes symboliques améliore la portabilité des applications CPI-C.

    Pour faciliter la compréhension, cette référence présente les types de données en termes absolus (et non #defined).

    Dans l’écriture d’applications, vous devez utiliser les constantes symboliques de WINCPIC. Fichier H.

    Constantes symboliques

    La plupart des paramètres fournis à et retournés par CPI-C sont des entiers 32 bits. Pour simplifier le codage, les valeurs de ces paramètres sont représentées par des constantes symboliques significatives, qui sont établies par #define instructions dans le WINCPIC. Fichier d’en-tête H. Par exemple, la valeur CM_MAPPED_CONVERSATION représente l’entier 1. Par souci de lisibilité, utilisez uniquement les constantes symboliques lors de l’écriture de programmes.

    Chaînes

    Toutes les chaînes sont au format ASCII lorsqu’elles sont transmises à l’interface CPI-C.

    Validité des paramètres de sortie

    Les paramètres retournés par CPI-C ne sont valides que si l’appel CPI-C est exécuté correctement, comme indiqué par un code de retour de CM_OK.

Dans cette section