本節描述通訊共用程式介面(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表示。