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

State Changes (状態の変化)

会話は RESET 以外の任意の状態にすることができます。

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