다음을 통해 공유


Set_Fill(CPI-C)

Set_Fill 호출(함수 이름 cmsf)은 프로그램이 논리 레코드 형식으로 데이터를 받을지 또는 지정된 데이터 길이로 데이터를 수신할지 여부를 지정합니다. 이 호출은 기본 대화에서만 허용됩니다.

구문

  
CM_ENTRY Set_Fill(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *fill,                    
  CM_INT32 FAR *return_code              
);  

매개 변수

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

채우기
제공된 매개 변수입니다. 프로그램에서 데이터를 받을 양식을 지정합니다. 가능한 선택 항목은 다음과 같습니다.

CM_FILL_BUFFER
로컬 프로그램은 Receive 호출의 requested_length 매개 변수에 지정된 바이트 수에 도달하거나 데이터가 끝날 때까지 데이터를 습니다. 논리 레코드 형식과 관계없이 데이터가 수신됩니다.

CM_FILL_LL
데이터는 논리적 레코드 형식으로 수신됩니다. 수신된 데이터는 전체 논리 레코드, 수신 호출의 requested_length 매개 변수와 동일한 논리 레코드의 일부 또는 논리 레코드의 끝일 수 있습니다.

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

반환 코드

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

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

  • conversation_ID 또는 채우기로 지정된 값이 잘못되었습니다.

  • 현재 대화가 매핑됩니다.

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

상태 변경

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

상태 변경은 없습니다.

설명

Set_Fill Initialize_Conversation또는Accept_Conversation 설정된 기본 채우기를 재정의합니다. 기본 채우기 는 CM_FILL_LL.

채우기 값은 모든 후속 Receive 호출에 영향을 줍니다. Set_Fill 호출을 재발행하여 변경할 수 있습니다.