次の方法で共有

Set_Fill (CPI-C)

Set_Fill呼び出し (関数名 cmsf) は、プログラムが論理レコードの形式でデータを受信するか、指定された長さのデータとして受け取るかを指定します。 この呼び出しは、基本的な会話でのみ許可されます。

構文

  
CM_ENTRY Set_Fill(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *fill,                    
  CM_INT32 FAR *return_code              
);

パラメーター

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

注ぐ
指定されたパラメーター。 プログラムがデータを受信するフォームを指定します。 可能な選択肢は次のとおりです。

CM_FILL_BUFFER
ローカル プログラムは、Receive 呼び出しの requested_length パラメーターで指定されたバイト数に達するか、データの末尾までデータを 受信 します。 論理レコード形式に関係なく、データが受信されます。

CM_FILL_LL
データは論理レコード形式で受信されます。 受信するデータには、完全な論理レコード、Receive 呼び出しのrequested_length パラメーターと等しい論理レコードの一部、または論理レコードの末尾を指定できます。

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

リターン コード

CM_OK
プライマリ リターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_PARAMETER_CHECK
プライマリ リターン コード。次のいずれかが発生しました。

  • conversation_IDまたは fill で指定された値が無効です。

  • 現在の会話がマップされます。

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

状態の変更

会話は RESET を除く任意の状態にすることができます。

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

注釈

Set_Fillは、Initialize_ConversationまたはAccept_Conversationによって確立された既定の塗りつぶしをオーバーライドします。 既定の 塗りつぶし はCM_FILL_LLです。

塗りつぶしの値は、後続のすべての受信呼び出しに影響します。 Set_Fill呼び出しを再発行することで変更できます。