Set_Receive_Type (CPI-C)

Set_Receive_Type呼叫 (函式名稱cmsrt) 指定程式將如何在後續接收呼叫上接收資料。 它會覆寫 Initialize_ConversationAccept_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_ConversationAccept_Conversation傳回。

receive_type
提供的參數。 指定程式在後續 接收 呼叫上接收資料的方式。 可能的值包括:

CM_RECEIVE_AND_WAIT
本機程式會接收夥伴計畫目前提供的任何資料。 如果沒有可用的資料,本機程式會等待資料到達。

CM_RECEIVE_IMMEDIATE
本機程式會接收夥伴計畫目前提供的任何資料。 如果沒有可用的資料,本機程式就不會等候。

return_code
從此呼叫傳回的程式碼。 本主題稍後會列出有效的傳回碼。

傳回碼

CM_OK
主要傳回碼;呼叫已成功執行。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; conversation_IDreceive_type 指定的值無效,或變數的位址無效。

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

狀態變更

交談可以處於 [重設] 以外的任何狀態。

沒有狀態變更。