共用方式為


Set_Conversation_Type (CPI-C)

Set_Conversation_Type呼叫 (函 名稱 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_IDconversation_type指定的值無效。

  • conversation_type 參數會指定對應的交談,但填滿特性會設定為 CM_FILL_BUFFER,這與對應的交談不相容。 將交談類型變更為對應的之前,您必須發出 Set_Fill 呼叫,將填滿類型變更為CM_FILL_LL。

  • conversation_type參數會指定對應的交談。 不過,先前 的Set_Log_Data 呼叫只允許在基本交談中,仍然有效。

    CM_PRODUCT_SPECIFIC_ERROR
    主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。