共用方式為


CPI-C 呼叫

本節說明通訊 (CPI-C) 呼叫的一般程式設計介面。 系統會針對每個呼叫提供下列資訊:

  • 呼叫的假名和實際的 C 函式名稱。

  • 呼叫的定義。

  • 呼叫所使用的參數清單,以及每個參數的資料類型。 每個函式的原型都會在 WINCPIC 中宣告。H 檔案。

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

  • 交談狀態,其中可以發出通話。

  • 交談在從呼叫傳回時可以變更的狀態。 不會注明未造成狀態變更的條件。 例如,參數檢查和狀態檢查不會造成狀態變更。

  • 描述呼叫使用的其他資訊。

    Data types (資料類型)

    在 WINCPIC 中 ,#define 語句建立所提供及接收自 CPI-C 參數的資料類型為符號常數。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的傳回碼所示。

本節內容