呼叫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_ID 或 return_control 指定的值無效。
CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。
狀態變更
交談必須處於 INITIALIZE 狀態。
沒有狀態變更。
備註
此呼叫會覆寫 Initialize_Conversation所建立的預設傳回控件。 根據預設,在配置會話時會傳回控件。 發出 [配置 ] 呼叫之後,便無法發出此呼叫。
如需會話的詳細資訊,請參閱 撰寫 CPI-C 應用程式。
如果 LU 無法配置工作階段,則會在 [配置 ] 呼叫上傳回通知。