共用方式為

Set_Partner_LU_Name (CPI-C)

  • 發行項

叫用程式會發出 Set_Partner_LU_Name呼叫 ( 函式名稱 cms) ，以指定 LU) 名稱 (夥伴邏輯單元。 當發出 Initialize_Conversation 呼叫時，此呼叫會覆寫衍生自側邊資訊的夥伴 LU 名稱。 發出 配置 之後，就無法發出此呼叫。 發出此呼叫不會影響側邊資訊本身。

語法

  
CM_ENTRY Set_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_length,    
  CM_INT32 FAR *return_code              
);

參數

conversation_ID
提供的 參數。 指定交談的識別碼。 此參數的值是由 Initialize_Conversation傳回。

partner_LU_name
提供的 參數。 指定夥伴 LU 名稱的起始位址。 模式名稱最多可以包含 17 個 ASCII 字元。 允許的字元為：

  • 大寫字母。

  • 從 0 到 9 的數位。

    合作夥伴 LU 名稱可以是：

  • 包含一到八個字元的別名。

  • 由 2 到 17 個字元組成的完整網路名稱。 句點會將網路識別碼 (從零到八個字元分隔，) 網路 LU 名稱 (可以是 1 到 8 個字元) 。 如果網路識別碼長度為零個字元，則仍需要句點。

    合作夥伴 LU 名稱必須符合在設定期間建立的夥伴 LU 名稱。

    partner_LU_name_length
    提供的 參數。 指定夥伴 LU 名稱的長度。 範圍是從 1 到 17。

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

傳回碼

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

CM_PROGRAM_STATE_CHECK
主要傳回碼;交談不是處於 INITIALIZE 狀態。

CM_PROGRAM_PARAMETER_CHECK
主要傳回碼;發生下列其中一項：

  • conversation_ID指定的值無效。

  • partner_LU_name_length指定的值超出範圍， (大於 17 或小於 1) 。

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

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。

備註

在發出[配置] 之前，不會偵測partner_LU_name的無效值。