Set_Send_Type(CPI-C)

Set_Send_Type 호출(함수 이름 cmsst)은 다음 Send_Data 호출에서 데이터를 보내는 방법을 지정합니다. Initialize_Conversation 또는Accept_Conversation 설정된 기본 송신 형식을 재정의합니다. 기본 송신 형식은 CM_BUFFER_DATA 데이터만(제어 정보 없음)을 전송해야 함을 나타냅니다.

send_type 값은 모든 후속 Send_Data 호출에 영향을 줍니다. Set_Send_Type 다시 발행하여 변경할 수 있습니다.

구문

  
CM_ENTRY Set_Send_Type(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *send_type,               
  CM_INT32 FAR *return_code              
);  

매개 변수

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

send_type
제공된 매개 변수입니다. 다음 Send_Data 호출에서 데이터를 보내는 방법을 지정합니다. 가능한 값은 다음과 같습니다.

CM_BUFFER_DATA
Send_Data 가리키는 데이터는 버퍼가 채워지거나 플러시될 때까지 버퍼에 저장됩니다.

CM_SEND_AND_FLUSH
Send_Data 가리키는 데이터는 즉시 전송됩니다.

CM_SEND_AND_CONFIRM
데이터는 확인 요청과 함께 즉시 전송되어야 합니다.

CM_SEND_AND_PREP_TO_RECEIVE
전송 프로그램의 대화 상태가 RECEIVE로 변경되고 있다는 알림과 함께 데이터가 파트너 프로그램에 즉시 전송됩니다.

CM_SEND_AND_DEALLOCATE
데이터는 할당 취소 알림과 함께 즉시 전송됩니다.

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

반환 코드

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

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

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

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

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

  상태 변경

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

  상태 변경은 없습니다.

설명

Send_Data 가리키는 데이터와 함께 추가 정보를 전송하는 send_type 값을 사용하면 발급된 통화 수를 경제화할 수 있습니다. 다음 표에서는 Send_Data 동등성을 요약합니다.

send_type 이 값으로 설정된 Send_Data	send_type CM_BUFFER_DATA 로 설정된 Send_Data 과 같습니다.
CM_SEND_AND_FLUSH	플러시
CM_SEND_AND_CONFIRM	확인
CM_SEND_AND_PREP_TO_RECEIVE	Prepare_To_Receive
CM_SEND_AND_DEALLOCATE	할당 취소