共用方式為

Set_Sync_Level (CPI-C)

  • 發行項

叫用程式發出 Set_Sync_Level呼叫 ( 函式名稱 cmssl) ，以指定交談的同步處理層級。 同步處理層級會決定程式是否透過 Confirm 和 Confirmed 呼叫同步處理其處理。

此呼叫會覆寫 Initialize_Conversation 呼叫所建立的同步處理層級。 預設同步處理層級CM_NONE，表示沒有同步處理。 在發出 配置 呼叫之後，無法發出此呼叫。

語法

  
CM_ENTRY Set_Sync_Level(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *sync_level,              
  CM_INT32 FAR *return_code              
);

參數

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

sync_level
提供的參數。 指定交談的同步處理層級。 可能的值包括：

CM_NONE
程式不會執行確認處理。

CM_CONFIRM
程式可以執行確認處理。

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

傳回碼

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

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

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

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

  • sync_level參數會指定CM_NONE但發生下列其中一項：send_type 參數設定為CM_SEND_AND_CONFIRM、prepare_to_receive_type參數設定為 CM_PREP_TO_RECEIVE_CONFIRM，或deallocate_type設定為 CM_DEALLOCATE_CONFIRM。

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

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。