Accept_Conversation(CPI-C)

호출된 프로그램에서 Accept_Conversation 호출(함수 이름 cmaccp)을 실행하여 들어오는 대화를 수락하고 특정 대화 특성을 설정합니다. 초기 대화 특성 목록은 초기 대화 특성을 참조하세요.

구문

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

매개 변수

conversation_ID
반환된 매개 변수입니다. 대화의 식별자를 지정합니다. 후속 CPI-C 호출에서 사용되며 반환 코드가 CM_OK 또는 CM_OPERATION_INCOMPLETE 경우 반환됩니다. 반환 코드가 CM_OPERATION_INCOMPLETE 경우 애플리케이션에서 conversation_ID 매개 변수를 사용하여 대화를 기다리거나 취소할 수 있습니다.

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

반환 코드

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

CM_PROGRAM_STATE_CHECK
기본 반환 코드; 들어오는 대화(차단 모드에만 해당)가 없거나 TP(로컬 트랜잭션 프로그램) 이름이 설정되지 않았습니다.

CM_OPERATION_INCOMPLETE
기본 반환 코드; 비블로킹 작업이 대화에서 시작되었지만 완료되지 않았습니다. 프로그램은 작업이 완료되기를 기다리거나 Cancel_Conversation 작업 및 대화를 취소하는 Wait_For_Conversation 실행할 수 있습니다.

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

상태 변경

대화는 Accept_Conversation 발급될 때 RESET 상태여야 합니다.

호출에 성공하면 대화가 RECEIVE 상태로 변경됩니다. 호출이 실패하면 상태는 변경되지 않은 상태로 유지됩니다.

설명

이 호출을 성공적으로 실행하면 CPI-C는 8 바이트 대화 식별자를 생성합니다. 이 식별자는 이 대화에서 호출된 프로그램에서 발급한 다른 모든 CPI-C 호출에 필요한 매개 변수입니다.

들어오는 대화는 지정된 대상 TP 이름에 따라 수락되며, 이는 설정된 로컬 TP 이름과 일치해야 합니다. 로컬 TP 이름은 구현 종속 메서드 또는 Specify_Local_TP_Name 호출하는 프로그램에서 설정할 수 있습니다. 이러한 방식으로 프로그램에는 둘 이상의 로컬 TP 이름이 있을 수 있습니다. 프로그램은 Extract_TP_Name 호출하여 들어오는 대화에 지정된 이름을 검색할 수 있습니다.

프로그램이 이전에 Specify_Local_TP_Name 호출한 경우 비블로킹 모드에서 작업이 수행됩니다. 그렇지 않으면 차단 모드에서 수행됩니다.