Wait_For_Conversation (CPI-C)
La chiamata Wait_For_Conversation (nome funzione cmwait) attende il completamento di un'operazione avviata quando la caratteristica della conversazione processing_mode è stata impostata su CM_NON_BLOCKING e CM_OPERATION_INCOMPLETE è stata restituita nel parametro return_code.
Sintassi
CM_ENTRY Wait_For_Conversation(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *conversation_return_code,
CM_INT32 FAR *return_code
);
Parametri
conversation_ID
Parametro restituito. Specifica l'identificatore per la conversazione in cui è stata completata l'operazione. Il valore di questo parametro è stato restituito da Initialize_Conversation o Accept_Conversation.
conversation_return_code
Parametro restituito. Specifica la return_code dall'operazione completata. I valori dipendono dall'operazione originariamente rilasciata.
return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.
Codici restituiti
CM_OK
Codice restituito primario; la chiamata eseguita correttamente.
CM_SYSTEM_EVENT
Codice restituito primario; l'attesa è stata completata non perché l'operazione è stata completata, ma perché si è verificato un evento di sistema.
CM_PROGRAM_STATE_CHECK
Codice restituito primario; il programma non ha operazioni incomplete in sospeso.
CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.
Modifiche di stato
La modifica dello stato dipende dall'operazione completata e dal relativo codice restituito.
Commenti
Il programma deve avere un'operazione incompleta in sospeso in una conversazione.