Wait_For_Conversation (CPI-C)
L’appel Wait_For_Conversation (nom de la fonction cmwait) attend la fin d’une opération qui a été lancée lorsque la caractéristique de conversation processing_mode a été définie sur CM_NON_BLOCKING et que CM_OPERATION_INCOMPLETE a été retournée dans le paramètre return_code.
Syntaxe
CM_ENTRY Wait_For_Conversation(
unsigned char FAR *conversation_ID,
CM_INT32 FAR *conversation_return_code,
CM_INT32 FAR *return_code
);
Paramètres
conversation_ID
Paramètre retourné. Spécifie l’identificateur de la conversation sur laquelle l’opération s’est terminée. La valeur de ce paramètre a été retournée par Initialize_Conversation ou Accept_Conversation.
conversation_return_code
Paramètre retourné. Spécifie le return_code de l’opération qui se termine. Ses valeurs dépendent de l’opération qui a été émise à l’origine.
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
Code de retour principal ; l’appel a été exécuté avec succès.
CM_SYSTEM_EVENT
Code de retour principal ; l’attente terminée non pas parce que l’opération s’est terminée, mais parce qu’un événement système s’est produit.
CM_PROGRAM_STATE_CHECK
Code de retour principal ; le programme n’a pas d’opération incomplète en cours.
CM_PRODUCT_SPECIFIC_ERROR
Code de retour principal ; une erreur spécifique au produit s’est produite et a été enregistrée dans le journal des erreurs des produits.
Changements d'état
Le changement d’état dépend de l’opération qui s’est terminée et de son code de retour.
Remarques
Le programme doit avoir une opération incomplète en suspens sur une conversation.