通过

Extract_Partner_LU_Name (CPI-C)

  • 项目

Extract_Partner_LU_Name调用 (函数名称 cme) 返回指定会话的伙伴 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
主返回代码;发生特定于产品的错误，并且已记录在产品错误日志中。

状态更改

会话可以处于除 RESET 之外的任何状态。

没有状态更改。

注解

(TP) 的可调用 CPI-C 事务程序仅在成功完成此函数调用后接收完全限定的网络名称。 可调用的 CPI-C TP 无法使用此调用检索别名。