Set_Partner_LU_Name(CPI-C)

호출 프로그램에서 Set_Partner_LU_Name 호출(함수 이름 cmspln)을 실행하여 LU(파트너 논리 단위) 이름을 지정합니다. 이 호출은 Initialize_Conversation 호출이 실행되었을 때 측면 정보에서 파생된 파트너 LU 이름을 재정의합니다. 할당이 실행된 후에는 이 호출을 실행할 수 없습니다. 이 호출을 실행해도 측면 정보 자체에는 영향을 주지 않습니다.

구문

  
CM_ENTRY Set_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 반환되었습니다.

partner_LU_name
제공된 매개 변수입니다. 파트너 LU 이름의 시작 주소를 지정합니다. 모드 이름은 최대 17개의 ASCII 문자를 포함할 수 있습니다. 허용되는 문자는 다음과 같습니다.

• 대문자

• 0에서 9까지의 숫자입니다.

  파트너 LU 이름은 다음 중 하나일 수 있습니다.

• 1~8자로 구성된 별칭입니다.

• 2~17자로 구성된 정규화된 네트워크 이름입니다. 마침표는 네트워크 LU 이름(1자에서 8자까지 가능)과 네트워크 식별자(0자에서 8자까지 가능)를 구분합니다. 네트워크 식별자가 0자인 경우 마침표는 여전히 필요합니다.

  파트너 LU 이름은 구성 중에 설정된 파트너 LU의 이름과 일치해야 합니다.

  partner_LU_name_length
  제공된 매개 변수입니다. 파트너 LU 이름의 길이를 지정합니다. 범위는 1에서 17까지입니다.

  return_code
  이 호출에서 반환된 코드입니다. 유효한 반환 코드는 이 항목의 뒷부분에 나와 있습니다.

반환 코드

CM_OK
기본 반환 코드; 호출이 성공적으로 실행되었습니다.

CM_PROGRAM_STATE_CHECK
기본 반환 코드; 대화가 INITIALIZE 상태가 아닙니다.

CM_PROGRAM_PARAMETER_CHECK
기본 반환 코드; 다음 중 하나가 발생했습니다.

• conversation_ID 지정한 값이 잘못되었습니다.

• partner_LU_name_length 지정된 값이 범위를 벗어났습니다(17보다 크거나 1보다 작음).

  CM_PRODUCT_SPECIFIC_ERROR
  기본 반환 코드; 제품별 오류가 발생하여 제품 오류 로그에 기록되었습니다.

상태 변경

대화는 INITIALIZE 상태여야 합니다.

상태 변경은 없습니다.

설명

할당이 실행될 때까지 partner_LU_name 잘못된 값을 지정하는 것은 검색되지 않습니다.