Partager via

Set_Conversation_Type (CPI-C)

L’appel Set_Conversation_Type (cmsct du nom de fonction) est émis par le programme appelant pour définir une conversation comme étant mappée ou de base. Cet appel remplace le type de conversation par défaut établi par Initialize_Conversation. Le type de conversation par défaut est CM_MAPPED_CONVERSATION. Cet appel ne peut pas être émis une fois l’allocation émise.

Syntaxe

  
CM_ENTRY Set_Conversation_Type(   
  unsigned char FAR *conversation_ID,    
  CM_INT32 FAR *conversation_type,    
    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.

conversation_type
Paramètre fourni. Spécifie le type de conversation à allouer par Allocation. Les valeurs possibles sont les suivantes :

  • CM_BASIC_CONVERSATION

  • CM_MAPPED_CONVERSATION

    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 conversation_type n’est pas valide.

  • Le paramètre conversation_type spécifie une conversation mappée, mais la caractéristique de remplissage est définie sur CM_FILL_BUFFER, qui est incompatible avec les conversations mappées. Avant de changer le type de conversation en mappage, vous devez émettre l’appel Set_Fill pour modifier le type de remplissage en CM_FILL_LL.

  • Le paramètre conversation_type spécifie une conversation mappée. Toutefois, un appel précédent Set_Log_Data , autorisé uniquement dans les conversations de base, est toujours en vigueur.

    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.

  • Last updated on