WinCPICExtractEvent 함수는 애플리케이션이 Microsoft® Windows® CPI-C(Common Programming Interface for Communications) 대화에 사용되는 이벤트 핸들을 확인하는 메서드를 제공합니다.
구문
VOID WINAPI WinCPICExtractEvent(
unsigned char FAR*conversation_ID,HANDLE FAR*event_handle, CM_INT32 FAR*return_code);
매개 변수
conversation_ID
이 이벤트가 사용되는 대화의 식별자를 지정합니다. 이 매개 변수는 초기 Accept_Conversation 호출에서 반환됩니다.
event_handle
반환된 매개 변수입니다. 이 대화에서 사용되는 이벤트의 핸들입니다. 핸들이 등록되지 않은 경우 이 매개 변수는 NULL로 반환됩니다.
return_code
이 호출에서 반환된 코드입니다. 유효한 반환 코드는 이 항목의 뒷부분에 나와 있습니다.
반환 코드
CM_OK
함수가 성공적으로 실행되었습니다.
CM_PROGRAM_PARAMETER_CHECK
이 함수에 전달된 매개 변수 중 하나 이상이 잘못되었습니다.
설명
비동기 대화에서 동사가 실행되면 비동기적으로 완료되는 경우 CM_OPERATION_INCOMPLETE 반환합니다. 이벤트가 대화에 등록된 경우 애플리케이션은 WaitForSingleObject 또는 WaitForMultipleObjects 를 호출하여 동사의 완료에 대한 알림을 받을 수 있습니다. WinCPICExtractEvent 를 사용하면 CPI-C 애플리케이션에서 이 이벤트 핸들을 확인할 수 있습니다. 동사가 완료되면 애플리케이션은 Wait_For_Conversation호출하여 비동기 동사에 대한 반환 코드를 결정해야 합니다. Cancel_Conversation함수를 호출하여 작업 및 대화를 취소할 수 있습니다.
이벤트가 등록되지 않은 경우 비동기 동사는 현재와 같이 완료됩니다. 즉, 애플리케이션이 CPI-C 라이브러리에 등록한 창에 메시지를 게시합니다.