共用方式為


Accept_Conversation (CPI-C)

Accept_Conversation呼叫 (函 名稱 cmaccp) 是由叫用的程式發出,以接受傳入交談並設定特定交談特性。 如需初始交談特性的清單,請參閱 初始交談特性

語法

  
CM_ENTRY Accept_Conversation(   
   unsigned char FAR *conversation_ID,    
      CM_INT32 FAR *return_code              
);  

參數

conversation_ID
傳回的參數。 指定交談的標識碼。 它會由後續 CPI-C 呼叫使用,如果傳回碼是CM_OK或CM_OPERATION_INCOMPLETE,則會傳回。 如果傳回碼是CM_OPERATION_INCOMPLETE,應用程式可以使用 conversation_ID 參數來等候或取消交談。

return_code
從這個呼叫傳回的程序代碼。 本主題稍後會列出有效的傳回碼。

回傳代碼

CM_OK
主要傳回碼;已成功執行的呼叫。

CM_PROGRAM_STATE_CHECK
主要傳回碼;沒有傳入對話(僅限封鎖模式),或尚未設定本機交易程式 (TP) 名稱。

CM_OPERATION_INCOMPLETE
主要傳回碼;交談上已啟動非封鎖作業,但尚未完成。 程式可以發出 Wait_For_Conversation ,等待作業完成或 Cancel_Conversation 取消作業和交談。

CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。

狀態變更

發出 Accept_Conversation 時,交談必須處於 RESET 狀態。

如果呼叫成功,交談會變更為 RECEIVE 狀態。 如果呼叫失敗,狀態會維持不變。

備註

成功執行此呼叫時,CPI-C 會產生8位元組的交談標識碼。 此標識碼是這個交談上所叫用程序發出之所有其他 CPI-C 呼叫的必要參數。

傳入交談會根據他們指定的目標 TP 名稱接受,這必須符合已設定的本機 TP 名稱。 本機 TP 名稱可以透過實作相依的方法或呼叫 Specify_Local_TP_Name的程式來設定。 如此一來,程式可以有多個本機 TP 名稱。 程式可以呼叫 Extract_TP_Name ,以探索傳入交談中指定的名稱。

如果程式先前已呼叫 Specify_Local_TP_Name ,則作業會以非封鎖模式執行;否則會以封鎖模式執行。