Wait_For_Conversation (CPI-C)

Der Wait_For_Conversation Aufruf (Funktionsname cmwait) wartet auf den Abschluss eines Vorgangs, der initiiert wurde, wenn das processing_mode Unterhaltungsmerkmal auf CM_NON_BLOCKING festgelegt wurde und CM_OPERATION_INCOMPLETE im return_code-Parameter zurückgegeben wurde.

Syntax

  
CM_ENTRY Wait_For_Conversation(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *conversation_return_code,    
  CM_INT32 FAR *return_code              
);  

Die Parameter

conversation_ID
Zurückgegebener Parameter. Gibt den Bezeichner für die Unterhaltung an, für die der Vorgang abgeschlossen wurde. Der Wert dieses Parameters wurde von Initialize_Conversation oder Accept_Conversation zurückgegeben.

conversation_return_code
Zurückgegebener Parameter. Gibt den return_code aus dem abgeschlossenen Vorgang an. Die Werte hängen davon ab, welcher Vorgang ursprünglich ausgestellt wurde.

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
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt.

CM_SYSTEM_EVENT
Primärer Rückgabecode; Die Wartezeit wurde nicht abgeschlossen, weil der Vorgang abgeschlossen wurde, sondern weil ein Systemereignis aufgetreten ist.

CM_PROGRAM_STATE_CHECK
Primärer Rückgabecode; das Programm hat keinen unvollständigen Vorgang ausstehend.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Fehlerprotokoll der Produkte protokolliert.

Statusänderungen

Die Statusänderung hängt von dem abgeschlossenen Vorgang und dem Rückgabecode ab.

Bemerkungen

Das Programm muss einen unvollständigen Vorgang haben, der bei einigen Unterhaltungen ausstehend ist.

Siehe auch

Set_Processing_Mode (CPI-C)
Specify_Windows_Handle (CPI-C)