WinCPICExtractEvent

  • 發行項

WinCPICExtractEvent函式提供一個方法，讓應用程式判斷用於通訊 (CPI-C) 交談的 Microsoft® Windows® Common Programming Interface 的事件控制碼。

語法

  
        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 程式庫註冊的視窗。