共用方式為


Set_Receive_Type (CPI-C)

Set_Receive_Type呼叫 (函式名稱 cmsrt) 會指定程式在後續的 Receive 呼叫上接收數據的方式。 它會覆寫 由Initialize_ConversationAccept_Conversation 呼叫所建立的預設接收類型。 根據預設,如果發出 接收 呼叫時,程式會等候數據到達。

接收類型值會影響所有後續 的 Receive 呼叫。 您可以重新發出 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
主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。

狀態變更

交談可以是 RESET 以外的任何狀態。

沒有狀態變更。