CPI-C 呼叫

本節描述通訊共用程式介面(CPI-C)呼叫。 每通電話均提供以下資訊:

  • 呼叫的化名以及實際的 C 函式名稱。

  • 這是通話的定義。

  • 列出呼叫所使用的參數及每個參數的資料型態。 每個函式的原型會在 WINCPIC 中宣告。H檔案。

  • 每個輸入與輸出參數的描述。 參數名稱為假名,這些參數的實際名稱由應用程式宣告。 描述包含參數的可能值。

  • 通話說明通話可於何時發出。

  • 通話回來後對話可能轉換到的狀態。 不會導致狀態變化的條件則未被記錄。 例如,參數檢查和狀態檢查不會造成狀態變更。

  • 關於通話使用的補充資訊。

    數據類型

    CPI-C 所提供及接收參數的資料型態,透過 WINCPIC 中的 #define 陳述句建立為符號常數。H檔案。 例如,CM_INT32 代表 有符號的長整數 ,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表示。

本節中