次の方法で共有

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

状態の変更

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

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