CPI-C 呼び出し

このセクションでは、通信用の共通プログラミング インターフェイス (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 の戻りコードで示されます。

このセクションの内容