Set_Receive_Type (CPI-C)

  • [アーティクル]

Set_Receive_Type呼び出し (関数名 cmsrt) は、プログラムが後続の Receive 呼び出しでデータを受信する方法を指定します。 Initialize_ConversationまたはAccept_Conversation呼び出しによって確立された既定の受信の種類をオーバーライドします。 既定では、 受信 呼び出しが発行されたときに使用できない場合、プログラムはデータの到着を待機します。

受信の種類の値は、後続のすべての 受信 呼び出しに影響します。 Set_Receive_Typeを再発行することで変更できます。

構文

  
CM_ENTRY Set_Receive_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *receive_type,            
  CM_INT32 FAR *return_code              
);

パラメーター

conversation_ID
指定されたパラメーター。 会話の識別子を指定します。 このパラメーターの値は 、Initialize_Conversation または Accept_Conversationによって返されました。

receive_type
指定されたパラメーター。 後続の Receive 呼び出しでプログラムがデータを受信する方法を指定します。 次のいずれかの値になります。

CM_RECEIVE_AND_WAIT
ローカル プログラムは、パートナー プログラムから現在利用可能なすべてのデータを受け取ります。 使用可能なデータがない場合、ローカル・プログラムはデータの到着を待機します。

CM_RECEIVE_IMMEDIATE
ローカル プログラムは、パートナー プログラムから現在利用可能なすべてのデータを受け取ります。 使用可能なデータがない場合、ローカル・プログラムは待機しません。

return_code
この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。

リターン コード

CM_OK
主なリターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_PARAMETER_CHECK
主なリターン コード。 conversation_ID または receive_type で指定された値が無効であるか、変数のアドレスが無効です。

CM_PRODUCT_SPECIFIC_ERROR
主なリターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

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

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