Set_Log_Data呼叫 (函式名稱 cmsld) 會指定要傳送至夥伴邏輯單元的記錄訊息(記錄數據)及其長度。 此呼叫只允許在基本交談中。 它會覆寫默認記錄數據,也就是 Null,以及預設記錄數據長度,也就是零。
語法
CM_ENTRY Set_Log_Data(
unsigned char FAR *conversation_ID,
unsigned char FAR *log_data,
CM_INT32 FAR *log_data_length,
CM_INT32 FAR *return_code
);
參數
conversation_ID
提供的參數。 指定交談的標識碼。 此參數的值是由 Initialize_Conversation 或 Accept_Conversation 所傳回。
log_data
提供的參數。 指定要傳送至夥伴 LU 之數據的起始位址。 最多可以包含 512 個 ASCII 字元。 允許的字元為:
大寫和小寫字母。
數位從 0 到 9。
特殊字元。
空間。
log_data_length
提供的參數。 指定記錄數據的長度。 範圍是從 0 到 512 個字節。長度為 0 表示沒有記錄數據,而且會忽略 log_data 參數。
return_code
從這個呼叫傳回的程序代碼。 本主題稍後會列出有效的傳回碼。
回傳代碼
CM_OK
主要傳回碼;已成功執行的呼叫。
CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項:
conversation_ID指定的值無效。
交談類型設定為對應。
log_data_length指定的值超出範圍(大於 512 或小於 0)。
CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤,且已在產品錯誤記錄檔中記錄。
狀態變更
交談可以是 RESET 以外的任何狀態。
沒有狀態變更。
備註
當本機程式發出下列其中一個呼叫時, Set_Log_Data 指定的記錄數據會傳送給合作夥伴 LU: