Set_Prepare_To_Receive_Type (CPI-C)

  • 發行項

Set_Prepare_To_Receive_Type呼叫 (函式名稱cmsptr) 指定後續Prepare_To_Receive呼叫的執行方式。 它會覆寫 Initialize_Conversation 或 Accept_Conversation所建立的預設準備接收處理。 根據預設，準備接收處理是以交談的同步處理層級為基礎。

準備接收類型會影響所有後續 Prepare_To_Receive 呼叫。 您可以藉由重新發出 Set_Prepare_To_Receive_Type來變更。

語法

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

參數

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

prepare_to_receive_type
提供的參數。 指定後續 Prepare_To_Receive 呼叫的執行方式。 可能的值包括：

CM_PREP_TO_RECEIVE_CONFIRM
用來將邏輯單元傳送緩衝區的內容傳送給合作夥伴程式， (LU) 和確認要求。 收到確認之後，交談會變更為 RECEIVE 狀態。

CM_PREP_TO_RECEIVE_FLUSH
用來傳送合作夥伴計畫本機 LU 的內容傳送緩衝區，並將交談變更為 RECEIVE 狀態。

CM_PREP_TO_RECEIVE_SYNC_LEVEL
交談同步處理層級用來判斷準備接收處理。 預設同步處理層級是由 Initialize_Conversation 所建立，而且可由 Set_Sync_Level覆寫。

如果交談的同步處理層級CM_NONE，則預設值會傳送本機 LU 傳送緩衝區的內容給合作夥伴計畫，而交談會變更為 RECEIVE 狀態。 如果交談的同步處理層級CM_CONFIRM，則會將本機 LU 的內容傳送緩衝區和確認要求傳送給合作夥伴計畫。 當合作夥伴計畫發出 確認時，交談會變更為 RECEIVE 狀態，並回應確認要求。

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

傳回碼

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

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項：

  • prepare_to_receive_type或conversation_ID所指定的值無效。

  • prepare_to_receive_type參數會設定為 CM_PREP_TO_RECEIVE_CONFIRM，但交談同步處理層級會設定為 CM_NONE。

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

狀態變更

交談可以處於 RESET 以外的任何狀態。

沒有狀態變更。