次の方法で共有

Set_Sync_Level (CPI-C)

  • [アーティクル]

Set_Sync_Level呼び出し (関数名 cmssl) は、会話の同期レベルを指定するために呼び出し元のプログラムによって発行されます。 同期レベルは、プログラムが Confirm 呼び出しと Confirmed 呼び出しを介して処理を同期するかどうかを決定します。

この呼び出しは、 Initialize_Conversation 呼び出しによって確立された同期レベルをオーバーライドします。 既定の同期レベルはCM_NONEであり、同期がないことを示します。 Allocate 呼び出しが発行された後は、この呼び出しを発行できません。

構文

  
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
    主なリターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

会話は INITIALIZE 状態である必要があります。

状態の変更はありません。