このセクションでは、通信 (CPI-C) 呼び出しの共通プログラミング インターフェイスについて説明します。 呼び出しごとに次の情報が提供されます。
呼び出しの仮名と実際の C 関数名。
呼び出しの定義。
呼び出しで使用されるパラメーターの一覧と、各パラメーターのデータ型。 各関数のプロトタイプは WINCPIC で宣言されています。H ファイル。
各入力パラメーターと出力パラメーターの説明。 パラメーター名は仮名であり、これらのパラメーターの実際の名前はアプリケーション・プログラムによって宣言されます。 説明には、パラメーターの使用可能な値が含まれています。
通話を発行できる会話状態。
通話から戻ると会話が変更される可能性がある状態。 状態の変化を引き起こさない条件は示されません。 たとえば、パラメーター チェックと状態チェックでは、状態が変更されません。
呼び出しの使用を説明する追加情報。
データ型
CPI-C との間で指定および受信されるパラメーターのデータ型は、WINCPIC の #define ステートメントによってシンボリック定数として確立されます。H ファイル。 たとえば、CM_INT32 は符号付き long 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のリターン コードによって示されます。