共用方式為

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_ID 或 return_control 所指定的值無效。

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

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。

備註

此呼叫會覆寫 Initialize_Conversation所建立的預設傳回控制項。 根據預設，當配置會話時，會傳回控制項。 在發出 配置 呼叫之後，無法發出此呼叫。

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

如果 LU 無法配置會話，則會在 Allocate 呼叫上傳回通知。