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)