Set_TP_Name(CPI-C)

호출하는 프로그램에서 Set_TP_Name 호출(함수 이름 cmstpn)을 실행하여 파트너(호출 가능한) 프로그램 이름을 지정합니다. 이 호출은 Initialize_Conversation 호출이 실행되었을 때 사이드 정보에서 파생된 파트너 프로그램 이름을 재정의합니다. 할당 호출이 실행된 후에는 이 호출을 실행할 수 없습니다. 이 호출을 실행해도 사이드 정보 자체에는 영향을 주지 않습니다.

구문

  
CM_ENTRY Set_TP_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *TP_name,            
    CM_INT32 FAR *TP_name_length,          
  CM_INT32 FAR *return_code              
);  

매개 변수

conversation_ID
제공된 매개 변수입니다. 대화의 식별자를 지정합니다. 이 매개 변수의 값은 Initialize_Conversation 반환되었습니다.

TP_name
제공된 매개 변수입니다. 파트너 프로그램 이름의 시작 주소를 지정합니다. 프로그램 이름은 최대 64개의 ASCII 문자를 포함할 수 있습니다. 허용되는 문자는 다음과 같습니다.

• 대문자 및 소문자입니다.

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

• 공백을 제외한 특수 문자입니다.

  Set_TP_Name 사용하여 SNA TP(서비스 트랜잭션 프로그램)의 이름을 지정할 수 없습니다. 그러나 Set_CPIC_Side_Information 사용하여 이 작업을 수행할 수 있습니다.

  간지와 같은 더블 바이트 문자 집합은 지원되지 않습니다.

  TP_name_length
  제공된 매개 변수입니다. 파트너 프로그램 이름의 길이를 지정합니다. 범위는 1에서 64까지입니다.

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

반환 코드

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

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

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

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

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

• 변수의 주소가 잘못되었습니다.

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

상태 변경

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

상태 변경은 없습니다.