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,以探索傳入交談的實際名稱。