Extract_CPIC_Side_Information(CPI-C)

Extract_CPIC_Side_Information 호출(함수 이름 xcmesi)은 항목 번호 또는 기호 대상 이름에 대한 측면 정보를 반환합니다.

구문

  
CM_ENTRY Extract_CPIC_Side_Information(   
  CM_INT32 FAR *entry_number,          
  unsigned char FAR *sym_dest_name,    
  SIDE_INFO FAR *side_info_entry,      
  CM_INT32 FAR *side_info_entry_length,    
    CM_INT32 FAR *return_code            
);  

매개 변수

entry_number
제공된 매개 변수입니다. 반환할 측면 정보 항목의 숫자(인덱스)를 지정합니다. 첫 번째 항목은 1입니다.

프로그램은 대신 기호 대상 이름으로 측면 정보 항목을 조회할 수 있습니다. 이렇게 하려면 항목 번호를 0으로 설정합니다.

sym_dest_name
제공된 매개 변수입니다. 검색할 기호 대상 이름을 지정합니다.

entry_number 0보다 큰 숫자로 설정된 경우 이 매개 변수는 무시됩니다.

side_info_entry
반환된 매개 변수입니다. 측면 정보 항목을 지정합니다. 측면 정보 항목에 대한 자세한 설명은 Set_CPIC_Side_Information 참조하세요.

측면 정보 구조의 각 필드는 필요에 따라 왼쪽 맞춤되고 오른쪽에 공백으로 채워집니다.

side_info_entry_length
제공된 매개 변수입니다. 항상 124.

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

반환 코드

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

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

• entry_number 측면 정보 테이블의 최대 항목 수보다 큰 숫자 또는 0보다 작은 숫자를 지정했습니다.

• sym_dest_name 매개 변수가 잘못되었으며 entry_number 0으로 설정됩니다.

• side_info_entry_length 매개 변수가 124로 설정되지 않았습니다.

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

상태 변경

이 호출은 대화와 연결되지 않으며 모든 상태에 있을 수 있습니다.

상태 변경은 없습니다.

설명

보안 암호는 반환되지 않습니다. 측면 정보의 보안 사용자 식별자가 설정되지 않은 경우 보안 사용자 식별자 필드는 모든 공백으로 반환됩니다.