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 ，作業就會以非封鎖模式執行;否則，它會以封鎖模式執行。