Set_CPIC_Side_Information呼叫 （函 式 名稱 xcmssi） 會在記憶體中新增或取代側邊信息專案。 CPI-C 側信息專案會將一組交談特性與符號定義名稱產生關聯。 此呼叫會覆寫具有相同符號目的地名稱的專案。
語法
CM_ENTRY Set_CPIC_Side_Information(
unsigned char FAR *key_lock,
SIDE_INFO FAR *side_info_entry,
CM_INT32 FAR *side_info_entry_length,
CM_INT32 FAR *return_code
);
參數
key_lock
提供的參數。 這個參數已忽略。
side_info_entry
提供的參數。 指定側邊信息項目的內容。 下表描述 side_info_entry 結構，其定義側邊信息專案的格式。
| 抵消 | 說明 | 類型 | 長度 |
|---|---|---|---|
| 0 | sym_dest_name | unsigned char（無符號字元） | 8 個字節 |
| 8 | partner_LU_name | unsigned char（無符號字元） | 17 個字節 |
| 25 | 保留 | unsigned char（無符號字元） | 3 個字節 |
| 28 | TP_name_type | 帶正負號的long int | 32 位 |
| 32 | TP_name | unsigned char（無符號字元） | 64 個字節 |
| 96 | mode_name | unsigned char（無符號字元） | 8 個字節 |
| 104 | conversation_ security_type | 帶正負號的long int | 32 位 |
| 108 | security_user_ID | unsigned char（無符號字元） | 8 個字節 |
| 116 | security_password | unsigned char（無符號字元） | 8 個字節 |
sym_dest_name允許的字元是大寫字母（A 到 Z），以及 0 到 9 的數位。
Set_CPIC_Side_Information 是唯一 CPI-C 呼叫，可讓您將 SNA 服務交易計畫 （TP） 指定為合作夥伴計畫。 命名服務 TP 的 SNA 慣例最多為四個字元。 第一個字元是0x00與0x3F之間的十六進位位元組。 其餘字元會從 ASCII 轉譯為 EBCDIC。
如需其他欄位允許的字元，請參閱對應 Set_ 呼叫的描述。 例如，針對 [mode_name ] 字段，請參閱 呼叫Set_Mode_Name 的描述。
結構中的每個欄位都必須靠左對齊。 視需要以空格填補右邊的欄位。
side_info_entry_length
提供的參數。 指定 side_info_entry長度。 一律為 124。
return_code
從這個呼叫傳回的程序代碼。 本主題稍後會列出有效的傳回碼。
回傳代碼
CM_OK
主要傳回碼;已成功執行的呼叫。
CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項：
side_info_entry 結構中指定的值無效。
side_info_entry的左字元包含空格。
CM_PRODUCT_SPECIFIC_ERROR
主要傳回碼;發生產品特定的錯誤，且已在產品錯誤記錄檔中記錄。
狀態變更
交談可以是任何狀態。
沒有狀態變更。
備註
在側邊資訊中無效的字串參數（例如，指定不存在的夥伴邏輯單元 （LU），在發出 Allocate 之前不會偵測到。 錯誤會在 Allocate 之後的呼叫上傳回。