WinCPICExtractEvent

La función WinCPICExtractEvent proporciona un método para que una aplicación determine el identificador de eventos que se usa para una conversación de interfaz de programación común de Microsoft® Windows® para comunicaciones (CPI-C).

Sintaxis

  
        VOID WINAPI WinCPICExtractEvent(   
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
Parámetro devuelto. Identificador del evento que usa esta conversación. Si no se ha registrado ningún identificador, este parámetro devuelve como NULL.

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.

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. WinCPICExtractEvent permite que una aplicación CPI-C determine este identificador de eventos. Una vez completado el verbo, la aplicación debe llamar a Wait_For_Conversationpara determinar el código de retorno del verbo asincrónico. Se puede llamar a la función Cancel_Conversationpara cancelar una operación y una conversación.

Si no se ha registrado ningún evento, el verbo asincrónico se completa como lo hace en la actualidad, que está publicando un mensaje en la ventana que la aplicación se ha registrado con la biblioteca CPI-C.