WinCPICExtractEvent

Die WinCPICExtractEvent-Funktion stellt eine Methode für eine Anwendung bereit, um das Ereignishandle zu bestimmen, das für eine CPI-C-Konversation (Microsoft® Windows® Common Programming Interface for Communications) verwendet wird.

Syntax

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

Parameter

conversation_ID
Gibt den Bezeichner für die Konversation an, für die dieses Ereignis verwendet wird. Dieser Parameter wird vom anfänglichen Accept_Conversation-Aufruf zurückgegeben.

event_handle
Zurückgegebener Parameter. Das Handle des Ereignisses, das von dieser Unterhaltung verwendet wird. Wenn kein Handle registriert wurde, wird dieser Parameter als NULL zurückgegeben.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Die Funktion wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Mindestens ein parameter, der an diese Funktion übergeben wird, ist ungültig.

Hinweise

Wenn ein Verb für eine Nichtblockierungsunterhaltung ausgegeben wird, wird CM_OPERATION_INCOMPLETE zurückgegeben, wenn es asynchron abgeschlossen wird. Wenn ein Ereignis bei der Konversation registriert wurde, kann die Anwendung WaitForSingleObject oder WaitForMultipleObjects aufrufen, um über den Abschluss des Verbs benachrichtigt zu werden. WinCPICExtractEvent ermöglicht es einer CPI-C-Anwendung, dieses Ereignishandle zu bestimmen. Wenn das Verb abgeschlossen ist, muss die Anwendung Wait_For_Conversationaufrufen, um den Rückgabecode für das asynchrone Verb zu bestimmen. Die funktion Cancel_Conversationkann aufgerufen werden, um einen Vorgang und eine Konversation abzubrechen.

Wenn kein Ereignis registriert wurde, wird das asynchrone Verb wie derzeit abgeschlossen, d. h., indem eine Meldung im Fenster veröffentlicht wird, dass die Anwendung bei der CPI-C-Bibliothek registriert wurde.