Appels CPI-C

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 le 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 comprend les valeurs possibles du paramètre.

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

  • États vers lesquels la conversation peut changer lors du retour de l’appel. Les conditions qui n’entraînent pas de modification d’État ne sont pas indiquées. Par exemple, les contrôles de paramètres et les contrôles d’État n’entraînent 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 long int 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 (non #defined).

    Lors de 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, é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. Pour des raisons 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 dans l’interface CPI-C.

    Validité des paramètres de sortie

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

Dans cette section