WinCPICSetEvent
Die WinCPICSetEvent-Funktion verknüpft ein Ereignishandle mit einer Verbvervollständigung.
Syntax
VOID WINAPI WinCPICSetEvent(
unsigned char FAR* conversation_ID,HANDLE FAR* event_handle,
CM_INT32 FAR*return_code);
Parameter
conversation_ID
Gibt den Bezeichner für die Unterhaltung an, für die dieses Ereignis verwendet wird. Dieser Parameter wird vom ersten aufruf Accept_Conversation zurückgegeben.
event_handle
Das Handle des Ereignisses, das gelöscht werden soll, wenn ein asynchrones Verb in der Unterhaltung abgeschlossen ist. Dieser Parameter kann ein bereits definiertes Ereignis ersetzen oder ein bereits definiertes Ereignis entfernen (indem NULL als Parameter verwendet wird).
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.
CM_OPERATION_NOT_ACCEPTED
Dieser Wert gibt an, dass ein vorheriger Vorgang für diese Unterhaltung unvollständig ist und der WinCPICSetEvent-Aufruf nicht akzeptiert wurde.
Hinweise
Wenn ein Verb für eine Nichtblockierungsunterhaltung ausgegeben wird, gibt es CM_OPERATION_INCOMPLETE zurück, wenn es asynchron abgeschlossen wird. Wenn ein Ereignis bei der Unterhaltung registriert wurde, kann die Anwendung WaitForSingleObject oder WaitForMultipleObjects aufrufen, um über die Vervollständigung des Verbs benachrichtigt zu werden. Wenn das Verb abgeschlossen ist, muss die Anwendung Wait_For_Conversationaufrufen, um den Rückgabecode für das asynchrone Verb zu bestimmen.
Es liegt in der Verantwortung der Anwendung, das Ereignis wie bei anderen APIs zurückzusetzen.