Partager via

Set_Sync_Level (CPI-C)

  • Article

L’appel Set_Sync_Level (nom de fonction cmssl) est émis par le programme d’appel 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 Confirmer et Confirmer .

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 l’absence de synchronisation. Cet appel ne peut pas être émis après l’émission de l’appel d’allocation .

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’effectuent pas de traitement de confirmation.

CM_CONFIRM
Les programmes peuvent effectuer un traitement de confirmation.

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_PROGRAM_STATE_CHECK
Code de retour principal ; la conversation n’est pas à 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’une des opérations suivantes s’est produite : 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.

Changements d'état

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

Il n’y a aucun changement d’état.