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
기본 반환 코드; 제품별 오류가 발생하여 제품 오류 로그에 기록되었습니다.

상태 변경

대화는 RESET을 제외한 모든 상태에 있을 수 있습니다.

상태 변경은 없습니다.

설명

호출 가능한 CPI-C 트랜잭션 프로그램(TP)은 이 함수 호출이 성공적으로 완료된 경우에만 정규화된 네트워크 이름을 받게 됩니다. 호출 가능한 CPI-C TP가 이 호출을 사용하여 별칭 이름을 검색할 수 없습니다.