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 の名前を指定することはできません。

    漢字などの 2 バイト文字セットはサポートされていません。

    TP_name_length
    指定されたパラメーター。 ローカル プログラム名の長さを指定します。 範囲は 1 ~ 64 です。

    return_code
    この呼び出しから返されたコード。 有効なリターン コードについては、このトピックの後半で説明します。

リターン コード

CM_OK
プライマリ リターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_PARAMETER_CHECK
プライマリ リターン コード。次のいずれかが発生しました。

  • 指定されたTP_nameが無効です。

  • TP_name_lengthで指定された値が範囲外 (64 より大きいか、1 未満) です。

    CM_PRODUCT_SPECIFIC_ERROR
    プライマリ リターン コード。製品固有のエラーが発生し、製品エラー ログに記録されています。

State Changes (状態の変化)

呼び出しは特定の会話に関連付けられていないので、状態制限は適用されません。

状態の変更はありません。

注釈

プログラムは、この呼び出しを複数回発行して、複数の TP 名を持つ着信会話を処理できます。 プログラムは、 Extract_TP_Nameを呼び出すことによって、受信した会話の実際の名前を検出できます。