CPI-C 呼び出し
このセクションでは、通信用の共通プログラミング インターフェイス (CPI-C) 呼び出しについて説明します。 呼び出しごとに次の情報が提供されます。
呼び出しの仮名と実際の C 関数名。
呼び出しの定義。
呼び出しで使用されるパラメーターの一覧と、各パラメーターのデータ型。 各関数のプロトタイプは WINCPIC で宣言されています。H ファイル。
各入力パラメーターと出力パラメーターの説明。 パラメーター名は仮名であり、これらのパラメーターの実際の名前はアプリケーション・プログラムによって宣言されます。 説明には、 パラメーターの使用可能な値が含まれています。
会話は、呼び出しを発行できる状態です。
呼び出しからの復帰時に会話を変更できる状態。 状態の変更を引き起こさない条件は示されません。 たとえば、パラメーター チェックと状態チェックでは、状態が変更されません。
呼び出しの使用を説明する追加情報。
Data Types (データ型)
CPI-C との間で送受信されるパラメーターのデータ・タイプは、WINCPIC の #define ステートメントによってシンボリック定数として確立されます。H ファイル。 たとえば、CM_INT32は 符号付き long int を 表し、CM_PTR は遠い \* を表します。 シンボリック定数を使用すると、CPI-C アプリケーションの移植性が向上します。
このリファレンスでは、理解しやすくするために、データ型を絶対 ( #defined ではない) の用語で示します。
アプリケーションを記述するときは、WINCPIC のシンボリック定数を使用する必要があります。H ファイル。
シンボリック定数
CPI-C に指定され、CPI-C によって返されるほとんどのパラメーターは、32 ビット整数です。 コーディングを簡略化するために、これらのパラメーターの値は、WINCPIC の #define ステートメントによって確立される意味のあるシンボリック定数で表されます。H ヘッダー ファイル。 たとえば、CM_MAPPED_CONVERSATION値は整数 1 を表します。 読みやすくするために、プログラムの作成時にはシンボリック定数のみを使用してください。
文字列
CPI-C インターフェースを介して渡された場合、すべてのストリングは ASCII 形式になります。
出力パラメーターの有効性
CPI-C によって返されるパラメーターは、CM_OKの戻りコードで示されているように、CPI-C 呼び出しが正常に実行された場合にのみ有効です。