Llamadas a CPI-C
En esta sección se describen las llamadas a Common Programming Interface for Communications (CPI-C). Se proporciona la siguiente información para cada llamada:
El seudónimo de la llamada y el nombre real de la función de C.
Definición de la llamada.
Lista de los parámetros utilizados por la llamada y el tipo de datos para cada parámetro. El prototipo de cada función se declara en WINCPIC. Archivo H.
Descripción de cada parámetro de entrada y salida. Los nombres de parámetro son seudónimos y los nombres reales de estos parámetros se declaran mediante el programa de aplicación. La descripción incluye los valores posibles del parámetro .
Estados de conversación en los que se puede emitir la llamada.
Estados a los que la conversación puede cambiar al volver desde la llamada. Las condiciones que no provocan un cambio de estado no se indican. Por ejemplo, las comprobaciones de parámetros y las comprobaciones de estado no provocan un cambio de estado.
Información adicional que describe el uso de la llamada.
Tipo de datos
Los tipos de datos de los parámetros proporcionados y recibidos de CPI-C se establecen como constantes simbólicas mediante instrucciones #define en winCPIC. Archivo H. Por ejemplo, CM_INT32 representa int long con signo y CM_PTR representa mucho \*. El uso de constantes simbólicas mejora la portabilidad de las aplicaciones CPI-C.
Para facilitar la comprensión, esta referencia presenta los tipos de datos en términos absolutos (no #defined).
Al escribir aplicaciones, debes usar las constantes simbólicas de WINCPIC. Archivo H.
Constantes simbólicas
La mayoría de los parámetros proporcionados y devueltos por CPI-C son enteros de 32 bits. Para simplificar la codificación, los valores de estos parámetros se representan mediante constantes simbólicas significativas, que se establecen mediante instrucciones #define en WINCPIC. Archivo de encabezado H. Por ejemplo, el valor CM_MAPPED_CONVERSATION representa el entero 1. Por motivos de legibilidad, use solo las constantes simbólicas al escribir programas.
Cadenas
Todas las cadenas están en formato ASCII cuando se pasan a través de la interfaz CPI-C.
Validez de los parámetros de salida
Los parámetros devueltos por CPI-C solo son válidos si la llamada CPI-C se ejecuta correctamente, como se indica mediante un código de retorno de CM_OK.