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。 如果事件已向交談註冊,應用程式可以呼叫 WaitForSingleObjectWaitForMultipleObjects ,以在動詞命令完成時收到通知。 當動詞命令完成時,應用程式必須呼叫 Wait_For_Conversation來判斷非同步動詞命令的傳回碼。

應用程式必須負責重設事件,因為它與其他 Api 相同。

另請參閱

Cancel_Conversation (CPI-C)