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
この関数に渡される 1 つ以上のパラメーターが無効です。
CM_OPERATION_NOT_ACCEPTED
この値は、この会話に対する以前の操作が不完全であり、 WinCPICSetEvent 呼び出しが受け入れられなかったことを示します。
注釈
ブロックされていない会話で動詞が発行されると、非同期的に完了する場合はCM_OPERATION_INCOMPLETEが返されます。 イベントが会話に登録されている場合、アプリケーションは WaitForSingleObject または WaitForMultipleObjects を呼び出して、動詞の完了を通知できます。 動詞が完了したら、アプリケーションは Wait_For_Conversationを呼び出して、非同期動詞のリターン コードを決定する必要があります。
他の API と同様に、イベントをリセットするのはアプリケーションの責任です。