Set_Error_Direction(CPI-C)

Set_Error_Direction 호출(함수 이름 cmsed)은 프로그램이 데이터를 수신하는 동안 또는 데이터 전송을 준비하는 동안 오류를 감지했는지 여부를 지정합니다.

구문

  
CM_ENTRY Set_Error_Direction(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *error_direction,         
  CM_INT32 FAR *return_code              
);  

매개 변수

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

error_direction
제공된 매개 변수입니다. 프로그램에서 오류가 발생했을 때 데이터가 흐르는 방향을 지정합니다. 가능한 값은 다음과 같습니다.

• CM_RECEIVE_ERROR

  파트너 프로그램에서 받은 데이터에서 오류가 발생했습니다.

• CM_SEND_ERROR

  로컬 프로그램이 파트너 프로그램에 데이터를 보낼 준비를 하는 동안 오류가 발생했습니다.

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

반환 코드

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

CM_PROGRAM_PARAMETER_CHECK
기본 반환 코드; conversation_ID 또는 error_direction 지정한 값이 잘못되었습니다.

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

상태 변경

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

상태 변경은 없습니다.

설명

이 호출은 Initialize_Conversation 또는Accept_Conversation 설정된 기본 오류 방향을 재정의합니다. 기본 오류 방향은 CM_RECEIVE_ERROR.

오류 방향은 프로그램이 수신 및 수신데이터를 발급한 직후(data_received SEND_PENDING CM_NO_DATA_RECEIVED 이외의 값) 및 송신 표시기(status_received CM_SEND_RECEIVED)를 실행한 직후에 Send_Error 문제가 발생하는 경우에만 관련이 있습니다.

대화가 SEND_PENDING 상태 인 경우 프로그램은 수신된 데이터의 오류를 감지하거나 로컬 프로그램이 데이터를 보낼 준비를 하는 동안 오류가 발생한 경우 Send_Error 문제를 발생합니다. LU(논리 단위)에서 발생한 오류 종류(수신 또는 보내기)를 알 수 없으므로 프로그램은 Send_Error발급하기 전에 Set_Error_Direction 사용하여 오류 방향 정보를 제공해야 합니다. 새 오류 방향은 후속 Set_Error_Direction 변경될 때까지 계속 적용됩니다.

Send_Error 발급되면 파트너 프로그램은 다음 반환 코드 중 하나를 받습니다.

• error_direction CM_RECEIVE_ERROR 설정된 경우 CM_PROGRAM_ERROR_PURGING

• error_direction CM_SEND_ERROR 설정된 경우 CM_PROGRAM_ERROR_NO_TRUNC