WinCPICSetEvent
La función WinCPICSetEvent asocia un identificador de evento con una finalización de verbo.
Sintaxis
VOID WINAPI WinCPICSetEvent(
unsigned char FAR* conversation_ID,HANDLE FAR* event_handle,
CM_INT32 FAR*return_code);
Parámetros
conversation_ID
Especifica el identificador de la conversación para la que se usa este evento. Esta llamada inicial Accept_Conversation devuelve este parámetro.
event_handle
Identificador del evento que se va a borrar cuando se completa un verbo asincrónico en la conversación. Este parámetro puede reemplazar un evento ya definido o quitar un evento ya definido (si tiene NULL como parámetro).
return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.
Códigos de retorno
CM_OK
La función se ejecutó correctamente.
CM_PROGRAM_PARAMETER_CHECK
Uno o varios de los parámetros pasados a esta función no son válidos.
CM_OPERATION_NOT_ACCEPTED
Este valor indica que una operación anterior en esta conversación está incompleta y no se aceptó la llamada WinCPICSetEvent .
Comentarios
Cuando se emite un verbo en una conversación sin bloqueo, devuelve CM_OPERATION_INCOMPLETE si se va a completar de forma asincrónica. Si se ha registrado un evento con la conversación, la aplicación puede llamar a WaitForSingleObject o WaitForMultipleObjects para recibir una notificación de la finalización del verbo. Una vez completado el verbo, la aplicación debe llamar a Wait_For_Conversationpara determinar el código de retorno del verbo asincrónico.
Es responsabilidad de la aplicación restablecer el evento, como sucede con otras API.