次の方法で共有


Extract_Partner_LU_Name (CPI-C)

Extract_Partner_LU_Name呼び出し (関数名 cmepln) は、指定された会話のパートナー LU 名とパートナー LU 名の長さを返します。 これは、最大 8 バイトの別名、または最大 17 バイトの完全修飾ネットワーク名にすることができます。

構文

  
CM_ENTRY Extract_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 または Accept_Conversationによって返されました。

partner_LU_name
返されたパラメーター。 パートナー LU 名を含む変数を指定します。 (プログラムは、適切な変数へのポインターを指定する必要があります)。

partner_LU_name_length
返されたパラメーター。 パートナー LU 名の長さを指定します。

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

リターン コード

CM_OK
主なリターン コード。呼び出しが正常に実行されました。

CM_PROGRAM_PARAMETER_CHECK
主なリターン コード。 conversation_ID で指定された値が無効です。

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

State Changes (状態の変化)

会話は RESET 以外の任意の状態にすることができます。

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

注釈

呼び出し可能な CPI-C トランザクション・プログラム (TP) は、この関数呼び出しが正常に完了したときにのみ完全修飾ネットワーク名を受け取ります。 呼び出し可能な CPI-C TP は、この呼び出しを使用して別名を取得できません。