次の方法で共有

Set_Conversation_Type (CPI-C)

  • [アーティクル]

Set_Conversation_Type呼び出し (関数名 cmsct) は、呼び出し元のプログラムによって発行され、会話をマップまたは基本として定義します。 この呼び出しは、 Initialize_Conversationによって確立された既定の会話の種類をオーバーライドします。 既定の会話の種類はCM_MAPPED_CONVERSATIONです。 Allocate が発行された後は、この呼び出しを発行できません。

構文

  
CM_ENTRY Set_Conversation_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *conversation_type,    
    CM_INT32 FAR *return_code           
);

パラメーター

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

conversation_type
指定されたパラメーター。 Allocate によって割り当てられる会話の種類を指定 します。 次のいずれかの値になります。

  • CM_BASIC_CONVERSATION

  • CM_MAPPED_CONVERSATION

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

リターン コード

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

CM_PROGRAM_STATE_CHECK
主なリターン コード。会話が INITIALIZE 状態ではありません。

CM_PROGRAM_PARAMETER_CHECK
主なリターン コード。次のいずれかが発生しました。

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

  • conversation_type パラメーターはマップされた会話を指定しますが、塗りつぶしの特性は CM_FILL_BUFFER に設定され、マップされた会話と互換性がありません。 会話の種類をマップ済みに変更する前に、 Set_Fill 呼び出しを発行して、塗りつぶしの種類をCM_FILL_LLに変更する必要があります。

  • conversation_type パラメーターは、マップされた会話を指定します。 ただし、以前の Set_Log_Data 呼び出しは、基本的な会話でのみ許可されますが、引き続き有効です。

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

State Changes (状態の変化)

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

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