共用方式為


Set_Return_Control (CPI-C)

呼叫Set_Return_Control呼叫 (函式名稱 cmsrc) 是由叫用程式發出,以指定本機邏輯單元 (LU) 在本機程式配置呼叫的會話要求上,應該將控制權傳回至本機程式。

語法

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

參數

conversation_ID
提供的參數。 指定交談的標識碼。 此參數的值是由 Initialize_Conversation 所傳回。

return_control
提供的參數。 指定在 Allocate 呼叫上作用的本機 LU 何時應該將控制權傳回至本機程式。 以下是允許的值:

CM_IMMEDIATE
如果立即提供競爭獲勝者會話,LU 會配置競爭勝出會話,並將控制權傳回給程式。

CM_WHEN_SESSION_ALLOCATED
在配置會話或發生錯誤之前,LU 不會將控制權傳回給程式。 如果會話無法使用,程式會等候一個會話。 (如果會話限制為零,LU 會立即傳回控件。

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

回傳代碼

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

CM_PROGRAM_STATE_CHECK
主要傳回碼;交談不是處於 INITIALIZE 狀態。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; conversation_IDreturn_control 指定的值無效。

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

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。

備註

此呼叫會覆寫 Initialize_Conversation所建立的預設傳回控件。 根據預設,在配置會話時會傳回控件。 發出 [配置 ] 呼叫之後,便無法發出此呼叫。

如需會話的詳細資訊,請參閱 撰寫 CPI-C 應用程式

如果 LU 無法配置工作階段,則會在 [配置 ] 呼叫上傳回通知。