共用方式為

Set_Conversation_Type (CPI-C)

  • 發行項

叫用程式會發出 Set_Conversation_Type呼叫 (函式名稱 cmsct cmsct) ，以將交談定義為對應或基本。 此呼叫會覆寫 Initialize_Conversation所建立的預設交談類型。 預設交談類型CM_MAPPED_CONVERSATION。 發出 配置 之後，就無法發出此呼叫。

語法

  
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
    主要傳回碼;發生產品特定的錯誤，且已在產品錯誤記錄檔中記錄。

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。