Set_Conversation_Type (CPI-C)

  • Article

L’appel Set_Conversation_Type (nom de la fonction cmsct) est émis par le programme d’appel pour définir une conversation comme 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 après l’émission d’Allocation .

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é 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 dans l’état INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; l’un des événements suivants s’est produit :

  • 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, ce qui est incompatible avec les conversations mappées. Avant de remplacer le type de conversation par mappé, vous devez émettre l’appel Set_Fill pour remplacer le type de remplissage par CM_FILL_LL.

  • Le paramètre conversation_type spécifie une conversation mappée. Toutefois, un appel Set_Log_Data précédent, 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.

Changements d'état

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

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