WinCPICExtractEvent

La fonction WinCPICExtractEvent fournit une méthode permettant à une application de déterminer le handle d’événement utilisé pour une conversation CPI-C (Microsoft® Windows® Common Programming Interface for Communications).

Syntaxe

  
        VOID WINAPI WinCPICExtractEvent(   
unsigned char FAR*conversation_ID,HANDLE FAR*event_handle,    CM_INT32 FAR*return_code);  

Paramètres

conversation_ID
Spécifie l’identificateur de la conversation pour laquelle cet événement est utilisé. Ce paramètre est retourné par l’appel Accept_Conversation initial.

event_handle
Paramètre retourné. Handle de l’événement utilisé par cette conversation. Si aucun handle n’a été inscrit, ce paramètre est retourné sous la forme d’une valeur NULL.

return_code
Code retourné par cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.

Codes de retour

CM_OK
La fonction s’est exécutée avec succès.

CM_PROGRAM_PARAMETER_CHECK
Un ou plusieurs des paramètres passés à cette fonction ne sont pas valides.

Remarques

Lorsqu’un verbe est émis sur une conversation non bloquante, il retourne CM_OPERATION_INCOMPLETE s’il va se terminer de manière asynchrone. Si un événement a été inscrit avec la conversation, l’application peut appeler WaitForSingleObject ou WaitForMultipleObjects pour être avertie de la fin du verbe. WinCPICExtractEvent permet à une application CPI-C de déterminer ce handle d’événement. Une fois le verbe terminé, l’application doit appeler Wait_For_Conversationpour déterminer le code de retour du verbe asynchrone. La fonction Cancel_Conversationpeut être appelée pour annuler une opération et une conversation.

Si aucun événement n’a été inscrit, le verbe asynchrone se termine comme il le fait actuellement, c’est-à-dire en publiant un message dans la fenêtre que l’application a inscrite auprès de la bibliothèque CPI-C.