Set_Sync_Level (CPI-C)

L’appel Set_Sync_Level (nom de fonction cmssl) est émis par le programme appelant pour spécifier le niveau de synchronisation de la conversation. Le niveau de synchronisation détermine si les programmes synchronisent leur traitement via les appels Confirm et Confirm .

Cet appel remplace le niveau de synchronisation établi par l’appel Initialize_Conversation . Le niveau de synchronisation par défaut est CM_NONE, ce qui indique qu’aucune synchronisation n’est terminée. Cet appel ne peut pas être émis une fois l’appel Alloué émis.

Syntaxe

  
CM_ENTRY Set_Sync_Level(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *sync_level,              
  CM_INT32 FAR *return_code              
);  

Paramètres

conversation_ID
Paramètre fourni. Spécifie l’identificateur de la conversation. La valeur de ce paramètre a été retournée par Initialize_Conversation.

sync_level
Paramètre fourni. Spécifie le niveau de synchronisation de la conversation. Les valeurs possibles sont les suivantes :

CM_NONE
Les programmes n’effectueront pas de traitement de confirmation.

CM_CONFIRM
Les programmes peuvent effectuer le traitement de confirmation.

return_code
Code retourné à partir de 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_PROGRAM_STATE_CHECK
Code de retour principal ; la conversation n’est pas dans l’état INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; l’une des opérations suivantes s’est produite :

• La valeur spécifiée par conversation_ID ou sync_level n’est pas valide.

• Le paramètre sync_level spécifie CM_NONE mais l’un des éléments suivants s’est produit : le paramètre send_type est défini sur CM_SEND_AND_CONFIRM, le paramètre prepare_to_receive_type est défini sur CM_PREP_TO_RECEIVE_CONFIRM ou le deallocate_type est défini sur CM_DEALLOCATE_CONFIRM .

  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.

Modifications d’état

La conversation doit être dans l’état INITIALIZE.

Il n’y a aucune modification d’état.