共用方式為

Specify_Local_TP_Name (CPI-C)

  • 發行項

程式會發出 Specify_Local_TP_Name 呼叫 (函式名稱 cmsltp) ，指出它能夠接受導向至指定名稱的傳入交談。

語法

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

參數

TP_name
提供的 參數。 指定本機交易程式的起始位址， (TP) 名稱。 程式名稱最多可以包含 64 個 ASCII 字元。 允許的字元為：

  • 大寫和小寫字母。

  • 從 0 到 9 的數位。

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

    您無法使用 Specify_Local_TP_Name 來指定 SNA 服務 TP 的名稱。

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

    TP_name_length
    提供的 參數。 指定本機程式名稱的長度。 範圍從 1 到 64。

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

傳回碼

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

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

  • 提供的 TP_name 無效。

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

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

狀態變更

呼叫不會與特定交談相關聯，而且不會套用狀態限制。

沒有狀態變更。

備註

程式可以多次發出此呼叫，以處理具有多個 TP 名稱的傳入交談。 程式可以呼叫 Extract_TP_Name，以探索傳入交談的實際名稱。