Set_Prepare_To_Receive_Type(CPI-C)

Set_Prepare_To_Receive_Type 호출(함수 이름 cmsptr)은 후속 Prepare_To_Receive 호출이 실행되는 방법을 지정합니다. Initialize_Conversation 또는Accept_Conversation 설정된 기본 수신 준비 처리를 재정의합니다. 기본적으로 준비-수신 처리는 대화의 동기화 수준을 기반으로 합니다.

수신 준비 형식은 모든 후속 Prepare_To_Receive 호출에 영향을 줍니다. Set_Prepare_To_Receive_Type 재발행하여 변경할 수 있습니다.

구문

  
CM_ENTRY Set_Prepare_To_Receive_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *prepare_to_receive_type,    
  CM_INT32 FAR *return_code              
);  

매개 변수

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

prepare_to_receive_type
제공된 매개 변수입니다. 후속 Prepare_To_Receive 호출을 실행하는 방법을 지정합니다. 가능한 값은 다음과 같습니다.

CM_PREP_TO_RECEIVE_CONFIRM
파트너 프로그램에 LU(논리 단위)의 송신 버퍼 내용과 확인 요청을 보내는 데 사용됩니다. 확인을 받으면 대화가 RECEIVE 상태로 변경됩니다.

CM_PREP_TO_RECEIVE_FLUSH
로컬 RU의 콘텐츠를 파트너 프로그램에 보내고 버퍼를 보내고 대화를 RECEIVE 상태로 변경하는 데 사용됩니다.

CM_PREP_TO_RECEIVE_SYNC_LEVEL
대화 동기화 수준에서 수신 준비 처리를 결정하는 데 사용됩니다. 기본 동기화 수준은 Initialize_Conversation 설정되며 Set_Sync_Level 재정의할 수 있습니다.

대화의 동기화 수준이 기본값인 CM_NONE 경우 로컬 RU 보내기 버퍼의 콘텐츠가 파트너 프로그램으로 전송되고 대화가 RECEIVE 상태로 변경됩니다. 대화의 동기화 수준이 CM_CONFIRM 경우 로컬 RU 송신 버퍼의 내용과 확인 요청이 파트너 프로그램에 전송됩니다. 파트너 프로그램이 확인 요청에 응답하여 Confirmed를 발급하면 대화가 RECEIVE 상태로 변경됩니다.

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

반환 코드

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

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

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

• prepare_to_receive_type 매개 변수는 CM_PREP_TO_RECEIVE_CONFIRM 설정되지만 대화 동기화 수준은 CM_NONE 설정됩니다.

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

상태 변경

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

상태 변경은 없습니다.