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 一樣。