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