共用方式為

Set_TP_Name (CPI-C)

  • 發行項

叫用程式會發出 Set_TP_Name 呼叫 (函式名稱 cmstpn) ，以指定可叫用) 程式名稱的合作夥伴 (。 當發出 Initialize_Conversation 呼叫時，此呼叫會覆寫衍生自側邊資訊的合作夥伴計畫名稱。 發出 配置 呼叫之後，便無法發出此呼叫。 發出此呼叫不會影響側邊資訊本身。

語法

  
CM_ENTRY Set_TP_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *TP_name,            
    CM_INT32 FAR *TP_name_length,          
  CM_INT32 FAR *return_code              
);

參數

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

TP_name
提供的 參數。 指定合作夥伴計畫名稱的起始位址。 程式名稱最多可以包含 64 個 ASCII 字元。 允許的字元為：

  • 大寫和小寫字母。

  • 從 0 到 9 的數位。

  • 特殊字元，但空格除外。

    您無法使用 Set_TP_Name 來指定 SNA 服務交易程式的名稱， (TP) 。 不過，您可以使用 Set_CPIC_Side_Information 來執行此動作。

    不支援雙位元組字元集，例如漢字。

    TP_name_length
    提供的 參數。 指定合作夥伴計畫名稱的長度。 範圍從 1 到 64。

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

傳回碼

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

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

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

  • conversation_ID指定的值無效。

  • TP_name_length指定的值超出範圍 (大於 64 或小於 1) 。

  • 變數的位址無效。

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

狀態變更

交談必須處於 INITIALIZE 狀態。

沒有狀態變更。