共用方式為

Set_Receive_Type (CPI-C)

  • 發行項

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

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

CM_RECEIVE_AND_WAIT
本機計畫會接收合作夥伴計畫目前可用的任何資料。 如果沒有資料可用，本機程式會等候資料抵達。

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

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

傳回碼

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

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼; 由conversation_ID 或 receive_type 指定的值無效，或變數的位址無效。

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

狀態變更

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

沒有狀態變更。