다음을 통해 공유


WinCPICSetEvent

WinCPICSetEvent 함수는 이벤트 핸들을 동사 완성과 연결합니다.

구문

  
        VOID WINAPI WinCPICSetEvent(   
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_NOT_ACCEPTED
이 값은 이 대화에 대한 이전 작업이 불완전하고 WinCPICSetEvent 호출이 수락되지 않음을 나타냅니다.

설명

비동기 대화에서 동사가 실행되면 비동기적으로 완료되는 경우 CM_OPERATION_INCOMPLETE 반환합니다. 이벤트가 대화에 등록된 경우 애플리케이션은 WaitForSingleObject 또는 WaitForMultipleObjects 를 호출하여 동사의 완료에 대한 알림을 받을 수 있습니다. 동사가 완료되면 애플리케이션은 Wait_For_Conversation호출하여 비동기 동사에 대한 반환 코드를 결정해야 합니다.

다른 API와 마찬가지로 이벤트를 다시 설정하는 것은 애플리케이션의 책임입니다.

참고 항목

Cancel_Conversation(CPI-C)