WinCPICExtractEvent

WinCPICExtractEvent 函式提供一種方法,讓應用程式能判斷用於 Microsoft® Windows® 通訊通用程式介面(CPI-C)對話所使用的事件句柄。

語法

  
        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 函式庫註冊。