次の方法で共有

WinCPICExtractEvent

  • [アーティクル]

WinCPICExtractEvent 関数は、アプリケーションが Microsoft® Windows® Common Programming Interface for Communications (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
この関数に渡される 1 つ以上のパラメーターが無効です。

注釈

非ブロッキング会話に対して動詞が発行されると、非同期的に完了する場合はCM_OPERATION_INCOMPLETEが返されます。 イベントが会話に登録されている場合、アプリケーションは WaitForSingleObject または WaitForMultipleObjects を呼び出して、動詞の完了を通知できます。 WinCPICExtractEvent を使用すると、CPI-C アプリケーションでこのイベント ハンドルを決定できます。 動詞が完了したら、アプリケーションは Wait_For_Conversationを呼び出して、非同期動詞のリターン コードを決定する必要があります。 Cancel_Conversation関数を呼び出して、操作と会話を取り消すことができます。

イベントが登録されていない場合、非同期動詞は現在と同じように完了します。これは、アプリケーションが CPI-C ライブラリに登録したメッセージをウィンドウに投稿することです。