CPI-C 调用
本部分介绍通信的通用编程接口 (CPI-C) 调用。 每个调用都提供以下信息：
调用的假名和实际的 C 函数名称。
调用的定义。
调用使用的参数列表以及每个参数的数据类型。 每个函数的原型在 WINCPIC 中声明。H 文件。
每个输入和输出参数的说明。 参数名称为假名，这些参数的实际名称由应用程序声明。 说明包括 参数的可能值。
可在其中发出呼叫的会话状态。
从调用返回时，会话可以更改为的状态。 不会记录不会导致状态更改的条件。 例如，参数检查和状态检查不会导致状态更改。
描述调用用法的其他信息。
数据类型
WINCPIC 中的 #define 语句将提供给 CPI-C 和从 CPI-C 接收的参数的数据类型建立为符号常量。H 文件。 例如，CM_INT32表示 有符号的长 int，CM_PTR 表示 远 \*。 使用符号常量可提高 CPI-C 应用程序的可移植性。
为便于理解，此参考以绝对 (而不是 #defined) 术语形式呈现数据类型。
编写应用程序时，应使用 WINCPIC 中的符号常量。H 文件。
符号常量
向 CPI-C 提供和返回的大多数参数都是 32 位整数。 为了简化编码，这些参数的值由有意义的符号常量表示，这些常量由 WINCPIC 中的 #define 语句建立。H 头文件。 例如，值 CM_MAPPED_CONVERSATION 表示整数 1。 为了便于阅读，编写程序时仅使用符号常量。
字符串
通过 CPI-C 接口传递时，所有字符串均采用 ASCII 格式。
输出参数的有效性
仅当 CPI-C 调用成功执行时，CPI-C 返回的参数才有效，如 CM_OK 的返回代码所示。