Cancel_Conversation(CPI-C)

Cancel_Conversation 호출(함수 이름 cmcanc)은 대화(CM_OPERATION_INCOMPLETE 반환된 작업) 및 대화 자체에 대한 미해결 작업을 취소합니다.

구문

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

매개 변수

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

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

반환 코드

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

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

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

상태 변경

대화는 RESET을 제외한 모든 상태에 있어야 합니다.

반환 코드가 CM_OK 대화 상태가 RESET가 됩니다.

설명

지정된 conversation_ID 대해 다른 작업이 활성화된 동안 Cancel_Conversation 호출할 수 있습니다. 이렇게 하면 애플리케이션이 CPI-C 작업을 종료할 수 있지만 대화가 종료됩니다. 이 호출은 현재 애플리케이션 처리 모드에 관계없이 실행할 수 있습니다. 미해결 작업은 반환 코드로 CM_DEALLOCATED_ABEND 함께 반환됩니다.

대화는 ABEND_SVC 설정된 deallocate_type 할당 취소에 의해 종료됩니다. log_data 전송되지 않습니다. 시스템에서 이 작업을 즉시 수행할 수 없지만 지연은 프로그램에 투명합니다.

참고

미해결 Specify_Windows_Handle 비동기 호출이 있는 동안 Cancel_Conversation 호출되면 이러한 호출이 취소됩니다. 반환 코드가 취소됨으로 설정되고 완료 메시지가 게시됩니다.